Campaigns API
Errors
Every error is a JSON object with a single error string:
{ "error": "<message>" }| Status | Meaning |
|---|---|
400 Bad Request | The body or a query parameter is invalid, the fromEmail is not a verified sending identity, the audience is empty, or the launch is over today's sending limit |
401 Unauthorized | Missing, malformed, expired, or revoked API key |
403 Forbidden | The key lacks read:campaigns or write:campaigns |
404 Not Found | No campaign with that ID in this workspace, or a tag, contact or offering in the body that is not in it |
409 Conflict | The campaign's status does not allow this (editing a sent campaign, deleting a launched one), or the workspace's sending is paused |
429 Too Many Requests | Rate limit exceeded |
Examples
{ "error": "No tag named \"Farms\"." }{ "error": "This campaign is SENDING and can no longer be edited. Create a new campaign instead." }{ "error": "Only DRAFT campaigns can be deleted. This one is SCHEDULED; cancel it instead with POST /api/v1/campaigns/cmq2camp0alk34567890/cancel." }