Agent skill · data analytics · jeremylongshore
intercom-common-errors
Diagnose and fix Intercom API errors by HTTP status code and error type.
Why this skill is useful
Provides specific diagnostic commands and error handling patterns for the Intercom API that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq installed locally. Requires intercom account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
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: The full per-code catalog (causes + copy-paste fixes) lives in references/error-reference.md. Prerequisites An Intercom access token in INTERCOMACCESSTOKEN (Developer Hub > Your App > Authentication). curl and jq for the diagnostic commands. For the TypeScript fixes: the intercom-client SDK (npm install intercom-client). Instructions 1. Capture the error. Grab the HTTP status and the JSON body. Use Read on your app logs, or Grep the codebase for the failing call site to see how the request is built. 2. Match the code. Find the errors[].code in the Error Handling table below. 3. Confirm the token/limits first. Run the diagnostic script in references/diagnostics.md to rule out auth and rate-limit issues in one shot. 4. Apply the fix. Open references/error-reference.md, jump to your status code, and use the causes + fix snippet there. 5. Retry only retryable errors. 429 and 5xx are retryable with backoff; 4xx client errors are not — fix the request instead. Fast auth check: Output You resolve the request into one of three outcomes: Fixed request — a corrected token, added OAuth scope, valid payload, or existence check that makes the call succeed. Backoff-and-retry — for 429 / 5xx, a retry wrapper that respects X-RateLimit-Reset and exponential backoff. Escalation — for persistent 5xx, the requestid to hand to Intercom support along with the status-page state. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-common-errors