Skip to main content
Every public API error uses a stable envelope. 
{
  "error": {
    "code": "insufficient_scope",
    "message": "API key scope insufficient for action: campaigns:write",
    "requestId": "req_123",
    "details": {}
  }
}

​
Common codes

CodeMeaning
missing_authNo bearer key was provided.
invalid_api_keyThe key is invalid, revoked, or no longer active.
insufficient_scopeThe key does not grant the requested action.
workspace_requiredA workspace-scoped resource was called without a workspace target.
not_foundThe resource was not found or is not visible to this key.
rate_limitedThe key or organization exceeded a rate limit.
idempotency_conflictA repeated idempotency key was used with a different request body.
unsupported_operationThe operation is not part of the public Developer API.

​
Request IDs

Capture requestId when asking support to investigate a failed integration. Request logs in the FirstSales app can also be filtered by request ID.