Errors

Response shape

json
`{
  "error": {
    "code": "invalid_signature",
    "message": "Webhook signature verification failed.",
    "request_id": "req_9182"
  }
}`

Common codes

• unauthorized — missing or invalid API key.
• forbidden — key does not have scope for this endpoint.
• not_found — resource does not exist or is not visible to your tenant.
• rate_limited — you hit your rate limit; retry with backoff.
• invalid_request — malformed request body or missing fields.
• internal_error — transient server error, safe to retry.

Debugging with request_id

Every response includes a request_id. Share it with support and we can trace the entire lifecycle of your request end-to-end.