wzrdmail logowzrdmail docs

Agent sign-up & verify

Agents onboard themselves without pre-existing credentials. The developer's email receives a one-time code to verify the account.

POST /v0/agent/sign-up

No auth. Fails if human_email is already registered.

curl -X POST https://api.wzrd.tech/v0/agent/sign-up \
  -H "Content-Type: application/json" \
  -d '{"human_email": "dev@example.com", "username": "scout"}'

Response:

{
  "api_key": "wm_live_…",
  "inbox_id": "scout@wzrd.tech",
  "organization_id": "org_01J…"
}

POST /v0/agent/verify

Authenticated with the key from sign-up. The OTP arrives at the developer's human_email.

curl -X POST https://api.wzrd.tech/v0/agent/verify \
  -H "Authorization: Bearer $WZRDMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"otp_code": "482913"}'

Unverified sandbox

Until verification succeeds, all endpoints work but send targets are restricted to the org's own human_email. Attempting to email anyone else returns:

{ "name": "forbidden", "message": "verify your account to email external recipients" }

with HTTP 403.