Intercom

Manage conversations, contacts, and help articles.

Install

amodal connect intercom

Authentication

Bearer token authentication.

• INTERCOM_ACCESS_TOKEN — Intercom API access token

Endpoints

Conversations

• GET /conversations — List all conversations
• GET /conversations/{id} — Retrieve a conversation with its parts
• POST /conversations/{id}/reply — Reply to a conversation (confirmation)
• POST /conversations — Create a new conversation (confirmation)
• POST /conversations/{id}/parts — Add a note or assignment (confirmation)
• PUT /conversations/{id} — Update conversation attributes (confirmation)

Contacts

• GET /contacts — List all contacts
• GET /contacts/{id} — Retrieve a single contact
• POST /contacts/search — Search contacts with filters
• POST /contacts — Create a new contact (confirmation)
• PUT /contacts/{id} — Update a contact (confirmation)
• DELETE /contacts/{id} — Delete a contact (confirmation)

Articles

• GET /articles — List all help center articles
• GET /articles/{id} — Retrieve a single article
• DELETE /articles/{id} — Delete an article (confirmation)

Admin

• GET /admins — List all admins and teams
• GET /data_attributes — List all data attributes

Entities

• conversation, reply, contact, search, article, data_attribute, admin

Rules

• Rate limits vary by plan: Starter/Growth (1000/min), Pro/Premium (2000/min), Enterprise (custom)
• Conversation replies require message_type (comment for customer-visible, note for internal) and admin_id
• Customer replies to a closed conversation automatically reopen it; admin replies do not change state
• Contact search is eventually consistent — newly created contacts may take seconds to appear