Agent skill · marketing growth · jeremylongshore
intercom-core-workflow-a
Manage Intercom contacts: create, search, update, merge leads into users.
Why this skill is useful
Provides specific commands and workflows for managing Intercom contacts that the AI wouldn't reliably generate on its own.
What it needs
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 Contacts & Contact Management Overview Primary workflow for managing Intercom contacts. Covers creating users and leads, searching with filters, updating custom attributes, merging leads into users, and listing segments. This SKILL.md gives you the high-level workflow and the first example; drill into references/implementation.md for the full step-by-step code and references/examples.md for end-to-end flows. Prerequisites Completed intercom-install-auth setup Understanding of Intercom contact model (users vs leads) Valid API credentials with contacts read/write scope Instructions The contact workflow is six operations against the intercom-client SDK. Instantiate the client once, then call the operation you need: The six operations, in the order you typically reach for them: 1. Create contacts — contacts.create with role: "user" (identified, needs externalId) or role: "lead" (anonymous). 2. Search contacts — contacts.search with a single filter or a compound AND/OR query, plus pagination and sort. 3. Update a contact — contacts.update by contactId to change name or custom attributes. 4. Merge a lead into a user — contacts.merge({ from: leadId, into: userId }); the lead's conversations, events, and tags transfer to the user. 5. List segments — contacts.listSegments({ contactId }) to see which segments a contact belongs to. 6. Paginate all contacts — contacts.list with startingAfter cursor to stream the full contact base. Full code for every step, including compound-search filters and the async-generator pagination helper, is in references/implementation.md. Output Each operation returns a typed response from the SDK: create / update — a single contact object: { type: "contact", id, role, email, name, customAttributes, createdat, ... }. The id is the Intercom-generated handle you pass to later calls. search — { data: Contact[], totalCount, pages }. Iterate data; read totalCount for the match count; use pages.next.startingAfter to page. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-core-workflow-a