Test helpers tools

`sendmock_email_wait`

Wait until a matching email arrives; 408 on timeout.

Toolset email.

Read only

Input	Type	Description
to	string	A recipient contains.Example: `[email protected]`
subject	string	Subject contains.Example: `Verify your email`
since	string	Only match items newer than this time (default: 30 s ago).Example: `2026-10-26T09:30:00Z`
timeout	string	How long to wait, e.g. 10s (default 10s, at most 60s).Example: `10s`
project	string	Only this project's emails (its key); every project's when not set.Example: `shop`

Example call

{
  "name": "sendmock_email_wait",
  "arguments": {
    "to": "[email protected]",
    "subject": "Verify your email"
  }
}

Result: EmailDetail

API: GET/api/v1/wait/email
CLI: sendmock email wait
In the app: Mail (new emails appear live)

`sendmock_http_wait`

Wait until the catcher records a matching request; 408 on timeout.

Toolset http.

Read only

Input	Type	Description
bin	string	The bin name.Example: `slack`
method	string	The HTTP method.Example: `POST`
since	string	Only match items newer than this time (default: 30 s ago).Example: `2026-10-26T09:30:00Z`
timeout	string	How long to wait, e.g. 10s (default 10s, at most 60s).Example: `10s`

Example call

{
  "name": "sendmock_http_wait",
  "arguments": {
    "bin": "slack",
    "method": "POST"
  }
}

Result: CapturedHttpRequest

API: GET/api/v1/wait/http
CLI: sendmock http wait
In the app: HTTP Catcher (new requests appear live)

`sendmock_links_get`

The links of the latest email to a recipient.

Toolset extract.

Read only

Input	Type	Description
torequired	string	The recipient address.Example: `[email protected]`
timeout	string	Waits up to this long for one to arrive, e.g. 10s (at most 60s); 408 on timeout. Without it the answer is immediate.Example: `10s`
project	string	Only this project's emails (its key); every project's when not set.Example: `shop`

Example call

{
  "name": "sendmock_links_get",
  "arguments": {
    "to": "[email protected]",
    "timeout": "10s",
    "project": "shop"
  }
}

Result: LinksLookup

API: GET/api/v1/links
CLI: sendmock links --to <recipient>
In the app: Mail > open email > links panel

`sendmock_otp_get`

The latest one-time code sent to a recipient.

Toolset extract.

Read only

Input	Type	Description
torequired	string	Email address or phone number.Example: `[email protected]`
channel	string	email, sms or verify (default: any).Example: `email`
timeout	string	Waits up to this long for one to arrive, e.g. 10s (at most 60s); 408 on timeout. Without it the answer is immediate.Example: `10s`
project	string	Only this project's messages (its key); every project's when not set.Example: `shop`

Example call

{
  "name": "sendmock_otp_get",
  "arguments": {
    "to": "[email protected]",
    "channel": "email",
    "timeout": "10s"
  }
}

Result: OtpLookup

API: GET/api/v1/otp
CLI: sendmock otp --to <recipient>
In the app: Mail, SMS and Verify: the code beside each message

`sendmock_payment_wait`

Wait until a payment reaches a status; 408 on timeout.

Toolset payments.

Read only

Input	Type	Description
provider	string	The gateway key, e.g. stripe.Example: `stripe`
status	string	The status to wait for, e.g. succeeded.Example: `succeeded`
since	string	Only match items newer than this time (default: 30 s ago).Example: `2026-10-26T09:30:00Z`
timeout	string	How long to wait, e.g. 10s (default 10s, at most 60s).Example: `10s`

Example call

{
  "name": "sendmock_payment_wait",
  "arguments": {
    "provider": "stripe",
    "status": "succeeded"
  }
}

Result: PaymentDetail

API: GET/api/v1/wait/payment
CLI: sendmock payments wait
In the app: Payments (new and changed payments appear live)

`sendmock_sms_wait`

Wait until a matching SMS arrives; 408 on timeout.

Toolset sms.

Read only

Input	Type	Description
to	string	The recipient number.Example: `+8801700000000`
from	string	The sender number.Example: `+15550001111`
since	string	Only match items newer than this time (default: 30 s ago).Example: `2026-10-26T09:30:00Z`
timeout	string	How long to wait, e.g. 10s (default 10s, at most 60s).Example: `10s`
project	string	Only this project's messages (its key); every project's when not set.Example: `shop`

Example call

{
  "name": "sendmock_sms_wait",
  "arguments": {
    "to": "+8801700000000",
    "from": "+15550001111"
  }
}

Result: SmsMessageDetail

API: GET/api/v1/wait/sms
CLI: sendmock sms wait
In the app: SMS (new messages appear live)

`sendmock_webhook_delivery_wait`

Wait until a matching delivery finishes; 408 on timeout.

Toolset webhooks.

Read only

Input	Type	Description
endpoint	string	The endpoint id or name.Example: `Team Slack alerts`
event	string	The event type, e.g. email.received.Example: `email.received`
status	string	succeeded or failed.Example: `failed`
since	string	Only match items newer than this time (default: 30 s ago).Example: `2026-10-26T09:30:00Z`
timeout	string	How long to wait, e.g. 10s (default 10s, at most 60s).Example: `10s`

Example call

{
  "name": "sendmock_webhook_delivery_wait",
  "arguments": {
    "endpoint": "Team Slack alerts",
    "event": "email.received"
  }
}

Result: WebhookDeliveryDetail

API: GET/api/v1/wait/webhook
CLI: sendmock webhook deliveries wait
In the app: Webhooks > Deliveries (new deliveries appear live)