Emails and their lifecycle

Each email gets an id when you send it. Use that id to read its status, cancel a scheduled send, or match webhook events to the original message.

Status

Sending returns a status:

Status	Meaning
`sent`	Accepted by our sending infrastructure and handed off to the receiving server.
`scheduled`	Queued to send at `scheduled_at`.

Later events describe what happened to the message. They arrive as webhooks and are also visible on the email:

Event	Meaning
`email.sent`	Accepted by sending infrastructure.
`email.delivered`	Accepted by the recipient’s mail server.
`email.delivery_delayed`	The recipient’s server is delaying delivery and will retry.
`email.bounced`	Delivery failed permanently. The address is suppressed.
`email.complained`	The recipient marked the message as spam. The address is suppressed.
`email.opened`	The tracking pixel loaded.
`email.clicked`	A tracked link was followed.
`email.unsubscribed`	The recipient used the unsubscribe link.
`email.failed`	We couldn’t hand the message off.
`email.cancelled`	A scheduled email was cancelled before it sent.

Read an email

curl https://api.sendflit.com/v1/emails/<email_id> \
  -H "Authorization: Bearer $SENDFLIT_KEY"

List recent emails with GET /v1/emails.

Schedule an email

Pass an ISO 8601 timestamp as scheduled_at:

{
  "from": "reminders@yourdomain.com",
  "to": "user@example.com",
  "subject": "Your trial ends tomorrow",
  "html": "<p>...</p>",
  "scheduled_at": "2026-09-01T09:00:00Z"
}

Relative times such as “in one hour” aren’t supported. Compute the timestamp in your code. To cancel a scheduled email before it sends, use DELETE /v1/emails/{id}. The native API doesn’t change a scheduled time; cancel it and send a new email. The Resend-compatible API also supports rescheduling.

Recipients and content

One address per to. Use cc and bcc, or send one email per recipient with the batch endpoint.
Up to 10 attachments per email, 10 MB each.
Use absolute URLs for images. Inline cid: images arrive as attachments.

Get started

Core concepts

Tutorials

Guides

DNS guides

Emails and their lifecycle

Status

Read an email

Schedule an email

Recipients and content

​Status

​Read an email

​Schedule an email

​Recipients and content

Status

Read an email

Schedule an email

Recipients and content