Send Campaign

Send a campaign immediately. The recipient list is built from the campaign's audience, the campaign moves to sending, and emails are delivered asynchronously by a background job.

POST /v1/campaigns/{id}/send

Authentication

Requires a valid API key with campaigns:write scope.

Path Parameters

Parameter	Type	Description
id	integer	The campaign ID

Prerequisites

• The campaign must be in draft or scheduled status
• email_subject and email_body must be set
• The audience must resolve to at least one recipient

Request Example

curl -X POST "https://app.equipdash.com/api/v1/campaigns/42/send" \
  -H "Authorization: Bearer eqd_live_your_api_key"

Response (202 Accepted)

Returns the campaign with status sending and the resolved total_recipients. Poll Get Campaign to track progress via stats.

{
  "data": {
    "id": 42,
    "name": "Summer Kayak Promo",
    "description": "Promote summer kayak rentals",
    "kind": "one_off",
    "channel": "email",
    "status": "sending",
    "audience_type": "filter",
    "audience_filter": {
      "v": 2,
      "preset": "recent"
    },
    "email_subject": "Summer is here, {customer_name}!",
    "email_body": "<p>Hi {customer_name}, book your kayak now.</p>",
    "template_key": "promo_blast",
    "cta_text": "Book now",
    "cta_url": "https://example.com/book",
    "scheduled_at": null,
    "sent_at": null,
    "total_recipients": 250,
    "total_sent": 0,
    "created_at": "2026-07-01T09:00:00+00:00",
    "updated_at": "2026-07-20T10:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-07-20T10:00:00+00:00"
  }
}

Error Responses

Status	Code	Description
403	insufficient_scope	API key lacks campaigns:write scope
404	resource_not_found	Campaign not found
422	validation_error	email_subject or email_body is missing
422	invalid_state	Only draft or scheduled campaigns can be sent
422	invalid_state	No recipients found for the selected audience