Error Codes

When something goes wrong, DesignAdvertise returns structured error codes. Use this reference to understand what went wrong and how to fix it.

HTTP status codes

200 OK              — Request succeeded
201 Created         — Resource created successfully
204 No Content      — Request succeeded, no response body
400 Bad Request     — Invalid parameters or request body
401 Unauthorized    — Missing or invalid API key
403 Forbidden       — Valid key but insufficient permissions
404 Not Found       — Resource doesn't exist
409 Conflict        — Resource state conflict (e.g., launching already-active campaign)
422 Unprocessable   — Valid request but business logic rejected it
429 Too Many Reqs   — Rate limit exceeded
500 Server Error    — Internal error (contact support if persistent)

Application error codes

GOVERNANCE_VIOLATION    — Creative failed brand governance checks
BUDGET_EXCEEDED        — Requested budget exceeds account or plan limits
CONNECTION_EXPIRED     — Platform OAuth token needs re-authentication
CONNECTION_ERROR       — Platform API returned an error during sync
CREATIVE_POLICY        — Prompt or generated content violates content policy
AUDIENCE_TOO_NARROW    — Target audience is too small for the platform's minimum
AUDIENCE_TOO_BROAD     — Target audience exceeds recommended size
CAMPAIGN_INCOMPLETE    — Campaign is missing required fields for launch
QUOTA_EXCEEDED         — Plan usage limit reached for this resource type

Error response format

{
  "error": {
    "code": "GOVERNANCE_VIOLATION",
    "message": "Creative failed 2 brand governance checks.",
    "details": [
      {
        "rule": "color_palette",
        "severity": "error",
        "message": "Background color #FF0000 is not in your approved palette."
      },
      {
        "rule": "logo_placement",
        "severity": "error",
        "message": "Logo must appear in the top-right quadrant."
      }
    ]
  }
}