Skip to main content
PUT
Update a campaign

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

The campaign ID.

Body

application/json
name
string

The campaign name.

Maximum string length: 255
subject
string

The email subject line.

Maximum string length: 255
email_template_id
string<uuid>

The email template ID to use.

sender_id
string<uuid>

The sender ID to send from.

audience_type
enum<string>

The audience type.

Available options:
all_contacts,
contact_list,
segment
audience_id
string<uuid> | null

The contact list or segment ID. Required when audience_type is contact_list or segment.

preview_text
string | null

Preview text shown in email clients.

Maximum string length: 255
reply_to
string<email> | null

Reply-to email address.

Maximum string length: 255
scheduled_at
string<date-time> | null

Schedule the campaign for a future date. Must be in the future.

Response

Campaign updated 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"