Errors - FirstSales Developer

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

Code	Meaning
`missing_auth`	No bearer key was provided.
`invalid_api_key`	The key is invalid, revoked, or no longer active.
`insufficient_scope`	The key does not grant the requested action.
`workspace_required`	A workspace-scoped resource was called without a workspace target.
`not_found`	The resource was not found or is not visible to this key.
`rate_limited`	The key or organization exceeded a rate limit.
`idempotency_conflict`	A repeated idempotency key was used with a different request body.
`unsupported_operation`	The 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.