API error codes
Every RFC 9457 problem code the GetItDone public API can return: the stable code your integration switches on, what it means and how to fix it.
The GetItDone API returns RFC 9457 application/problem+json error documents.
Switch on the stable code — never on the human-readable title.
Each row's URL is the problem type URI the API publishes in the document
itself, so a client can follow type straight to the page that explains it.
| Status | Code | Title |
|---|---|---|
| 401 | missing_credentials | Missing credentials |
| 401 | invalid_api_key | Invalid API key |
| 401 | invalid_token | Invalid access token |
| 403 | insufficient_scope | Insufficient scope |
| 403 | feature_not_enabled | Feature not enabled on this plan |
| 400 | validation_failed | Request validation failed |
| 404 | resource_not_found | Resource not found |
| 429 | rate_limited | Rate limit exceeded |
| 429 | quota_exhausted | Plan quota exhausted |
| 400 | idempotency_key_missing | Idempotency-Key header required |
| 422 | idempotency_key_reused | Idempotency-Key reused with a different request |
| 409 | idempotency_in_progress | A request with this Idempotency-Key is still in progress |
| 422 | webhook_url_rejected | Webhook endpoint URL rejected |
| 409 | delivery_already_pending | A delivery for this event is already queued |
| 409 | conflict | Conflict |
| 409 | dependency_cycle | Dependency link would create a loop |
| 500 | internal_error | Internal server error |
Read this page as Markdown — plain text for AI agents. Every guide at once: llms-full.txt.
Webhooks
GetItDone outbound webhooks (Pro+): the task event catalog, Standard Webhooks signature verification, delivery retries, and secret rotation.
missing_credentials (HTTP 401): meaning and fix
Fix: send Authorization: Bearer gid_… with every call. missing_credentials (HTTP 401) means the GetItDone API request arrived with no API key.