Preview: SendMock has no stable release yet. These docs follow develop.

CLI reference

Test helpers commands

sendmock email wait

Wait until a matching email arrives; 408 on timeout.

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

Example

sendmock email wait --to [email protected] --subject 'Verify your email'

Output with --json: EmailDetail. Exit codes: 0, 1, 2, 4.

API
GET/api/v1/wait/email
MCP tool
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.

sendmock http wait [flags]
FlagTypeDescription
--bin <bin>string
The bin name.Example: slack
--method <method>string
The HTTP method.Example: POST
--since <since>string
Only match items newer than this time (default: 30 s ago).Example: 2026-10-26T09:30:00Z
--timeout <timeout>string
How long to wait, e.g. 10s (default 10s, at most 60s).Example: 10s

Example

sendmock http wait --bin slack --method POST

Output with --json: CapturedHttpRequest. Exit codes: 0, 1, 2, 4.

API
GET/api/v1/wait/http
MCP tool
sendmock_http_wait
In the app
HTTP Catcher (new requests appear live)

sendmock otp

The latest one-time code sent to a recipient.

sendmock otp --to <recipient> [flags]
FlagTypeDescription
--to <recipient>requiredstring
Email address or phone number.Example: [email protected]
--channel <channel>string
email, sms or verify (default: any).Example: email
--wait <wait>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 <project>string
Only this project's messages (its key); every project's when not set.Example: shop

Example

sendmock otp --to [email protected] --channel email --wait 10s

Output with --json: OtpLookup. Exit codes: 0, 1, 2, 3, 4.

API
GET/api/v1/otp
MCP tool
sendmock_otp_get
In the app
Mail, SMS and Verify: the code beside each message

sendmock payments wait

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

sendmock payments wait [flags]
FlagTypeDescription
--provider <provider>string
The gateway key, e.g. stripe.Example: stripe
--status <status>string
The status to wait for, e.g. succeeded.Example: succeeded
--since <since>string
Only match items newer than this time (default: 30 s ago).Example: 2026-10-26T09:30:00Z
--timeout <timeout>string
How long to wait, e.g. 10s (default 10s, at most 60s).Example: 10s

Example

sendmock payments wait --provider stripe --status succeeded

Output with --json: PaymentDetail. Exit codes: 0, 1, 2, 4.

API
GET/api/v1/wait/payment
MCP tool
sendmock_payment_wait
In the app
Payments (new and changed payments appear live)

sendmock sms wait

Wait until a matching SMS arrives; 408 on timeout.

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

Example

sendmock sms wait --to +8801700000000 --from +15550001111

Output with --json: SmsMessageDetail. Exit codes: 0, 1, 2, 4.

API
GET/api/v1/wait/sms
MCP tool
sendmock_sms_wait
In the app
SMS (new messages appear live)

sendmock webhook deliveries wait

Wait until a matching delivery finishes; 408 on timeout.

sendmock webhook deliveries wait [flags]
FlagTypeDescription
--endpoint <endpoint>string
The endpoint id or name.Example: Team Slack alerts
--event <event>string
The event type, e.g. email.received.Example: email.received
--status <status>string
succeeded or failed.Example: failed
--since <since>string
Only match items newer than this time (default: 30 s ago).Example: 2026-10-26T09:30:00Z
--timeout <timeout>string
How long to wait, e.g. 10s (default 10s, at most 60s).Example: 10s

Example

sendmock webhook deliveries wait --endpoint 'Team Slack alerts' --event email.received

Output with --json: WebhookDeliveryDetail. Exit codes: 0, 1, 2, 4.

API
GET/api/v1/wait/webhook
MCP tool
sendmock_webhook_delivery_wait
In the app
Webhooks > Deliveries (new deliveries appear live)