Zerokit
Open app
Emails

Retrieve email

Fetch a single email by ID. Returns 404 if the email belongs to another workspace or has been deleted.

GET
/emails/{id}

Fetch a single email by ID. Returns 404 if the email belongs to another workspace or has been deleted.

Authorization

bearerAuth
AuthorizationBearer <token>

Workspace-scoped API key issued via the dashboard. Send as Authorization: Bearer zk_live_... on every request.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/emails/email_2bV4dXyZ8AfQpkw7Lp"
{
  "id": "email_2bV4dXyZ8AfQpkw7Lp",
  "organizationId": "string",
  "apiKeyId": "string",
  "from": "Acme <[email protected]>",
  "to": [
    "[email protected]"
  ],
  "subject": "string",
  "status": "queued",
  "provider": "ses",
  "providerMessageId": "010f01...",
  "errorMessage": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "sentAt": "2019-08-24T14:15:22Z",
  "failedAt": "2019-08-24T14:15:22Z"
}
{
  "error": "The from domain is not verified for this organization."
}
{
  "error": "Not found"
}

List emails GET

Return every email in this workspace, newest-first. No pagination yet — workspaces with high volume should subscribe to a [webhook](/docs/webhooks) instead of polling this endpoint.

Send email POST

Queue a transactional email for delivery. Returns immediately with the email ID — SES handoff happens in the background. Subscribe to a [webhook](/docs/webhooks) to learn about delivery, bounces, opens, and clicks. The `from` domain must be verified for the workspace — see the [Quickstart](/docs/quickstart) for the DNS records.