Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.testbrick.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Email Blocks

Email blocks are a Pro feature. Free users can see the feature but need to upgrade to use it.
Email blocks let you test email-based API flows — like signup verification, OTP login, and password reset. TestBrick catches the email, extracts values from it, and passes them to the next block.

​
How it works

  1. Your API sends an email (e.g., OTP to verify a signup)
  2. The email block waits for the email to arrive in your TestBrick inbox
  3. You extract the OTP or verification link from the email
  4. The next block uses the extracted value to complete the flow

​
Setup

​
Your inbox address

Each project folder has a unique email inbox. Click the Inbox button in the toolbar to copy the address (e.g., abc123@inbox.testbrick.com). Use this email address in your API requests: 
{
  "email": "abc123@inbox.testbrick.com",
  "password": "test123"
}

​
Adding an email block

Click Email in the toolbar to add an email block.

​
Configuration

Click the email block to open the side panel with three tabs:

​
Settings

FieldDescriptionDefault
TimeoutHow long to wait for the email (seconds)60
From filterOnly match emails from this senderOptional

​
Extract

After running the flow, the email HTML appears in the Extract tab:
  1. Click Extract Value
  2. Hover over elements in the email preview — they highlight
  3. Click the OTP code or verification link
  4. Choose the extraction pattern (6-digit code, alphanumeric, custom regex)
  5. Click Save Extraction
Click to extract OTP Extraction options modal The extracted value becomes available as {{nodeId.value}} in subsequent blocks.

​
Assert

Toggle Assert email content to validate:
AssertionExample
Subject contains”Verification”
From equals”noreply@example.com”
Body contains”Your code is”

​
Example: OTP login flow

Block 1: POST /auth/login
  Body: {"email": "inbox@inbox.testbrick.com", "password": "demo123"}
  → API sends OTP email

Block 2: Email Block
  → Waits for email
  → Extracts 6-digit OTP
  
Block 3: POST /auth/verify-otp
  Body: {"email": "inbox@inbox.testbrick.com", "otp": "{{Block2.value}}"}
  → Verifies OTP using extracted code

Block 4: GET /profile
  Auth: Bearer {{Block3.body.token}}
  → Fetches profile using auth token
The click-to-extract feature uses the same precise CSS path extraction as UI test email testing — it works reliably across different email templates.