curl --request POST \
--url 'https://api.autosend.com/v1/campaigns' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Spring Sale Newsletter",
"subject": "Don'\''t miss our Spring Sale!",
"previewText": "Up to 50% off this weekend only",
"from": {
"email": "[email protected]",
"name": "Example Team"
},
"replyTo": "[email protected]",
"templateId": "60d5ec49f1b2c72d9c8b1234",
"toLists": ["60d5ec49f1b2c72d9c8b0001"],
"sendMode": "immediate",
"trackingClick": true,
"trackingOpen": true
}'
{
"success": true,
"data": {
"campaignId": "60d5ec49f1b2c72d9c8b4567",
"name": "Spring Sale Newsletter",
"subject": "Don't miss our Spring Sale!",
"previewText": "Up to 50% off this weekend only",
"status": "draft",
"sendMode": "immediate",
"from": {
"email": "[email protected]",
"name": "Example Team"
},
"replyTo": "[email protected]",
"templateId": "60d5ec49f1b2c72d9c8b1234",
"toLists": ["60d5ec49f1b2c72d9c8b0001"],
"excludeLists": [],
"trackingClick": true,
"trackingOpen": true,
"createdAt": "2026-03-01T10:00:00.000Z",
"updatedAt": "2026-03-01T10:00:00.000Z"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Display name of the campaign. Between 1 and 200 characters.
Email subject line. Between 1 and 998 characters.
Preview text shown in email clients before the message is opened. Maximum 200 characters.
Sender identity to use for this campaign.
Sender email address. Must be a valid email.
Sender display name. Maximum 200 characters.
id of a saved sender identity. Mutually usable with from.
Reply-to email address. Must be a valid email.
ID of the email template to use for this campaign.
Array of list or segment IDs to send the campaign to.
Array of list or segment IDs to exclude from sending.
ID of the unsubscribe group to associate with this campaign.
If true, the campaign will be sent immediately upon creation.
ISO 8601 date-time string at which to schedule the campaign for sending.
If true, the campaign is sent to all contacts in the global list.
If true, publishes and finalizes the campaign.
Enable or disable click tracking for this campaign.
Enable or disable open tracking for this campaign.
Delivery mode. One of: immediate, scheduled, gradual.
Growth strategy for gradual sending. One of: fixed, 1.25x, 1.5x, 1.75x, 2x. Required when sendMode is gradual.
Number of emails to send per day in gradual mode. Must be at least 1.
Timezone string (e.g. America/New_York) for scheduled or gradual sending.
Mark this campaign as the default campaign. Applies to create only.
Identifies the campaign builder type used to create this campaign. Applies to create only.
Response
Returns the newly created campaign object.
Indicates whether the request was successful.
The created campaign object.
Unique identifier of the new campaign.
Display name of the campaign.
Preview text shown in email clients.
Initial status of the campaign, typically draft.
Delivery mode: immediate, scheduled, or gradual.
Whether click tracking is enabled.
Whether open tracking is enabled.
ISO 8601 timestamp when the campaign was created.
ISO 8601 timestamp when the campaign was last updated.
Bearer authentication header of the form Bearer , where is your auth token.
Display name of the campaign.
Required string length: 1 - 200
Required string length: 1 - 998
Preview text shown in email clients.
Maximum string length: 200
Id of a saved sender identity.
ID of the email template to use.
List/segment IDs to send the campaign to.
List/segment IDs to exclude from sending.
ID of the unsubscribe group.
If true, send the campaign immediately.
ISO 8601 date-time to schedule the campaign.
If true, send to the entire global contact list.
If true, publish/finalize the campaign.
Enable or disable click tracking.
Enable or disable open tracking.
How the campaign is delivered.
Available options:
immediate,
scheduled,
gradual
Gradual send growth strategy (used when sendMode is 'gradual').
Available options:
fixed,
1.25x,
1.5x,
1.75x,
2x
Number of emails to send per day in gradual mode.
Required range: x >= 1
Timezone string for scheduled sending.
Mark as default campaign (create only).
Campaign builder type (create only).
Campaign created successfully.
