Skip to main content
POST
Create a campaign

Authorizations

Authorization
string
header
required

API key from your SendKit dashboard. Pass it as a Bearer token in the Authorization header.

Body

application/json
name
string
required

The campaign name.

Maximum string length: 255
Example:

"March Newsletter"

Response

Campaign created successfully

id
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

name
string
Example:

"March Newsletter"

subject
string | null
Example:

"Our latest updates"

preview_text
string | null
Example:

"Check out what's new"

reply_to
string | null
Example:

"support@example.com"

status
enum<string>
Available options:
draft,
scheduled,
sending,
sent,
partial_sent
Example:

"draft"

audience_type
enum<string>
Available options:
all_contacts,
contact_list,
segment
Example:

"contact_list"

audience_id
string<uuid> | null
template
object | null
sender
object | null
total_recipients
integer
Example:

1500

sent_count
integer
Example:

1200

failed_count
integer
Example:

5

scheduled_at
string<date-time> | null
Example:

"2026-03-15 10:00:00"

sent_at
string<date-time> | null
Example:

"2026-03-11 14:30:00"

created_at
string<date-time>
Example:

"2026-03-10 09:00:00"