Intercom Common Errors

Overview

Quick reference for diagnosing and fixing Intercom REST API errors by HTTP status code. Every Intercom error returns the same envelope, so triage is fast: read the errors[].code, match it to the table below, apply the fix.

All Intercom errors share this shape:

{
  "type": "error.list",
  "request_id": "req_abc123",
  "errors": [{ "code": "unauthorized", "message": "Access Token Invalid" }]
}

The full per-code catalog (causes + copy-paste fixes) lives in references/error-reference.md.