API Reference
Contacts
Custom Fields
Campaigns
Copy
curl --request GET \
--url 'https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567' \
--header 'Authorization: Bearer <token>'
Copy
{
"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": [],
"unsubscribeGroupId": "60d5ec49f1b2c72d9c8b0099",
"trackingClick": true,
"trackingOpen": true,
"scheduledAt": null,
"timezone": "America/New_York",
"createdAt": "2026-03-01T10:00:00.000Z",
"updatedAt": "2026-03-15T14:30:00.000Z"
}
}
Campaigns
Get Campaign
Retrieve the details of a specific campaign by its ID using the AutoSend API.
GET
/
campaigns
/
{campaignId}
Copy
curl --request GET \
--url 'https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567' \
--header 'Authorization: Bearer <token>'
Copy
{
"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": [],
"unsubscribeGroupId": "60d5ec49f1b2c72d9c8b0099",
"trackingClick": true,
"trackingOpen": true,
"scheduledAt": null,
"timezone": "America/New_York",
"createdAt": "2026-03-01T10:00:00.000Z",
"updatedAt": "2026-03-15T14:30:00.000Z"
}
}
Copy
curl --request GET \
--url 'https://api.autosend.com/v1/campaigns/60d5ec49f1b2c72d9c8b4567' \
--header 'Authorization: Bearer <token>'
Copy
{
"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": [],
"unsubscribeGroupId": "60d5ec49f1b2c72d9c8b0099",
"trackingClick": true,
"trackingOpen": true,
"scheduledAt": null,
"timezone": "America/New_York",
"createdAt": "2026-03-01T10:00:00.000Z",
"updatedAt": "2026-03-15T14:30:00.000Z"
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Path Parameters
The id of the campaign to retrieve.
Response
Returns the full campaign object for the given ID.Indicates whether the request was successful.
The campaign object.
Show data
Show data
Unique identifier of the campaign.
Display name of the campaign.
Email subject line.
Preview text shown in email clients.
Current status of the campaign. One of:
draft, scheduled, sending, sending_gradual, paused, sent, failed, aborted.How the campaign is delivered:
immediate, scheduled, or gradual.Reply-to email address.
ID of the email template used by this campaign.
List/segment IDs the campaign targets.
List/segment IDs excluded from this campaign.
ID of the unsubscribe group associated with this campaign.
Whether click tracking is enabled.
Whether open tracking is enabled.
ISO 8601 date-time when the campaign is scheduled to send. Null if not scheduled.
Timezone used for scheduled sending.
ISO 8601 timestamp when the campaign was created.
ISO 8601 timestamp when the campaign was last updated.
⌘I