Messages

Get latest verification code / magic link

Agent self-onboarding in one call. Returns the one-time code (OTP) or magic link from the most recent inbound message in this inbox, so an agent can sign up for a service or complete 2FA without parsing email bodies — from any language, no MCP required. Non-blocking: it scans recent inbound mail and returns immediately (found=false if nothing has arrived yet), so poll it on a short interval after triggering the signup.

get/v1/inboxes/{inbox_id}/verification

Request

  • Base URL: https://api.deadsimple.email
  • URL: https://api.deadsimple.email/v1/inboxes/{inbox_id}/verification
  • Auth: HTTP bearer

Path parameters

inbox_idstring required

Query parameters

from_containsstring

Only consider messages whose from address contains this substring.

sincestring date-time

Ignore messages received before this ISO-8601 timestamp. Pass the moment you triggered the signup to avoid returning a stale code.

windowinteger

Max recent inbound messages to scan (1–50).

Headers

X-Workspace-Idstring uuid

Target a specific workspace. Required for account-wide API keys that want workspace-scoped results.

Response

The extracted verification data, or found=false if none yet.

foundboolean
verification_codestring nullable
magic_link_urlstring nullable
expires_instring nullable
message_idstring
from_emailstring
received_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.