Senders

Manage verified sender email addresses

Individual email addresses can be verified as senders without verifying an entire domain.

List Senders

GET/v1/send/senders

List all verified and pending sender email identities.

Requires:send:read

List senders

curl "https://api.do.dev/v1/send/senders" \
-H "Authorization: Bearer YOUR_API_KEY"

Response200

{
"emailIdentities": [
  {
    "id": "identity_abc123",
    "email": "hello@example.com",
    "status": "verified",
    "isActive": true,
    "verifiedAt": 1707424200000
  }
],
"count": 3
}

Verify Sender

POST/v1/send/senders/verify

Initiate verification for a sender email address. Sends a verification email.

Requires:send:write

Body Parameters

emailstringrequired

Email address to verify

organizationIdstring

Organization to associate with

Verify a sender

curl -X POST "https://api.do.dev/v1/send/senders/verify" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "email": "hello@example.com" }'

Response202

{
"id": "identity_abc123",
"email": "hello@example.com",
"status": "pending",
"message": "Verification email sent. Check your inbox.",
"expiresIn": "24 hours"
}

Check Status

GET/v1/send/senders/{id}/status

Check verification status for an email identity.

Requires:send:read

Delete Sender

DELETE/v1/send/senders/{id}

Delete an email identity.

Requires:send:write