listmonk unofficial
POST/campaigns

Create a campaign

Creates a campaign from the campaign details supplied in the request body. Provide fields such as name, subject, and lists to define the campaign; all body fields are optional in the schema. A successful response contains the new campaign object.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

10 body fields

Campaign details to use when creating the campaign; every listed field is optional.

namestringoptional
The campaign name.
subjectstringoptional
The subject line for the campaign.
listsarray<number>optional
Numeric identifiers of the subscriber lists associated with the campaign.
from_emailstringoptional
The sender email address for the campaign.
content_typestringoptional
The campaign content type.
messengerstringoptional
The messaging channel used by the campaign.
typestringoptional
The campaign type.
tagsarray<string>optional
Tags associated with the campaign.
send_laterbooleanoptional
Whether to schedule the campaign to be sent later.
send_atobjectoptional
Scheduling details for the campaign, including optional `headers` and numeric `template_id` fields.

1 status code
200Returns the new campaign object in `data`, including campaign details such as its name, subject, lists, sender, type, tags, and scheduling information.
dataobjectoptional

Error handling

All request body fields are optional in the schema. Supply values using the fields' declared types: for example, lists and tags are arrays, while send_later is a boolean; send_at can include headers and template_id.