HTTP/1.1 404 Not Found
Content-Type: application/problem+json
{
"type": "https://www.geoboom.io/docs/api/errors#not_found",
"title": "not found",
"status": 404,
"code": "not_found",
"detail": "no such deal in this organisation",
"requestId": "..."
}Over MCP the same refusal is a tool result with isError set and the detail as its text. Match on code, never on detail, whose words may change. The list may grow; treat a code you do not know by its HTTP status.
invalid 400
The input does not fit the operation: a missing or malformed field, a value out of range, or a guarded call without an idempotency key.
Read detail, which names the field. Fix the input; retrying unchanged gets the same answer.
unauthorized 401
No bearer token, or one that is unknown, revoked or expired.
Send Authorization: Bearer <key or access token>. An OAuth client refreshes its access token; a key that was revoked needs a new one from Settings → Integrations.
no_credits 402
The organisation does not have the credits this would commit.
Tell the person; an owner tops up in the app under Billing. Nothing was spent.
forbidden 403
The key or grant does not hold the scope this operation needs, or the operation is only for people in the app.
Ask an owner for a key with the scope (or re-authorise the connector and tick it). Members, keys, deleting and billing are never available through the API.
grant_paused 403
An owner paused this key or connection.
Stop and tell the person; it is resumed from Settings → Integrations.
not_activated 403
The organisation is on the waiting list and cannot create projects or send yet.
Reads work; the rest waits until GEOboom activates the organisation.
not_found 404
No such thing in this organisation, or no operation at that path. Another organisation's ids are not found, not forbidden.
Check the id came from this organisation's lists, and the path from the reference.
conflict 409
The state does not allow it now: a newer message arrived on the thread, a run is already going, or a first call with this idempotency key did not finish and whether it took effect is unknown.
Read detail. Look at the current state (the thread, the campaign) before acting again, with a new idempotency key if it was a guarded call.
in_progress 409
The first call with this idempotency key is still running.
Wait for Retry-After (2 seconds) and send the same call with the same key; you will get its answer.
idempotency_mismatch 422
This idempotency key was already used for a different request.
A new action needs a new key. Reuse a key only to retry the exact same call.
rate_limited 429
Too many calls a minute for this operation on this key, or for the organisation as a whole.
Wait for Retry-After and slow down. Limits are per key and operation: reads 600 a minute, writes 120, spending and sending 30.
internal 500
Something went wrong on our side.
Retry later; a guarded call is safe to retry with the same key. If it persists, write to support@geoboom.io with the requestId.