Skip to main content
POST
/
campaigns
/
{campaignId}
/
send
Send a campaign now
curl --request POST \
  --url https://app.lettr.com/api/campaigns/{campaignId}/send \
  --header 'Authorization: Bearer <token>'
{
  "message": "Campaign scheduled for delivery.",
  "data": {
    "id": "0193e6a8-1f3a-7c2a-b9e2-1aa1d2e5d3f0",
    "name": "Spring Sale",
    "status": "sent",
    "sent_count": 124,
    "created_at": "2026-05-01T09:00:00+00:00",
    "stats": {
      "injections": 0,
      "deliveries": 0,
      "bounces": 0,
      "spam_complaints": 0,
      "opens": 0,
      "unique_opens": 0,
      "clicks": 0,
      "unique_clicks": 0,
      "unsubscribes": 0
    },
    "subject": "<string>",
    "from_email": "jsmith@example.com",
    "from_name": "<string>",
    "reply_to": "jsmith@example.com",
    "scheduled_at": "2023-11-07T05:31:56Z",
    "total_recipients": 123,
    "sent_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.lettr.com/llms.txt

Use this file to discover all available pages before exploring further.

Immediately dispatches a draft campaign. The campaign must be a draft with a subject, sender email, and content. Sending is asynchronous; the campaign transitions to preparing. Requires the campaigns:write scope. Not available to sandbox keys.

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
campaignId
string<uuid>
required

Campaign ID

Response

Campaign sending started.

​
message
string
required
Example:

"Campaign scheduled for delivery."

​
data
object

The updated campaign. Present on success; omitted in the rare case the campaign cannot be re-read immediately after the action (e.g. it was concurrently deleted).