Errors

Every error has the same shape, with the HTTP status set to match:

{
  "error": {
    "code": "invalid_request",
    "message": "account_priority.0: Invalid option: expected one of \"High\"|\"Medium\"|\"Nurture\"",
    "details": [
      {
        "path": "account_priority.0",
        "message": "Invalid option: expected one of \"High\"|\"Medium\"|\"Nurture\""
      }
    ]
  }
}

Status	code	When
400	`invalid_json` `invalid_cursor`	Malformed request or cursor.
401	`unauthorized`	Missing or invalid credential.
403	`forbidden`	The credential lacks the mcp.read scope.
404	`account_not_found` `not_found`	No such account in this workspace, or no such route.
410	`cursor_expired`	The cursor expired; start the list again.
422	`invalid_request`	A parameter failed validation; details lists each one.
429	`rate_limited`	Rate limited; wait Retry-After seconds.
500	`internal_error`	Our fault; retry, and contact support if it persists.

A 429 carries Retry-After (seconds). Endpoints list only the errors special to them.

Get started

Using the API

Webhooks