Create campaign
POST/v1/public/campaigns
Creates an email campaign in DRAFT status. All fields are optional at creation; the required ones (template, sender, subject, at least one contact list) are validated at start. The draft is not sent automatically — start it with the campaign schedule operation. Pass abTest to create an A/B (split) campaign: 2-10 subject variants are tested on a share of the contacts (abTest.percent), then the winning variant is sent to the rest. Follow-up and chunked sending are not stored in the draft — they are configured at start (see the schedule operation).
Request
Responses
- 200
- 400
- 401
- 403
- 422
- 429
- 500
Created campaign.
The request is invalid.
A valid Public API token is required.
The endpoint requires a scope that is not granted to the token.
The request is syntactically correct but cannot be processed.
The current API key exceeded the configured rate limit.
Response Headers
Number of seconds after which the request may be retried safely.
Internal server error.