Create and update Intercom Help Center articles and collections via the Articles API

domain: intercom.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Retrieve existing collections via GET /help_center/collections to get collection IDs and their parent_id hierarchy.
  2. Create an article: POST to /articles with a JSON body containing 'title', 'body' (HTML), 'author_id' (admin ID), 'state' ('published' or 'draft'), and optionally 'parent_id' and 'parent_type' ('collection' or 'section') to place it in a collection.
  3. To publish a draft article, PATCH /articles/{article_id} with 'state': 'published'.
  4. To update article content, PATCH /articles/{article_id} with 'title' and/or 'body'; the response returns the updated article.
  5. Delete an article with DELETE /articles/{article_id}; this is permanent and the URL becomes a 404 immediately.
  6. List all articles in a collection: GET /articles?help_center_id={id} or by filtering on parent_id in the results.

Known gotchas

Related routes

Create and publish Intercom Help Center articles via API
developers.intercom.com · 6 steps · unrated
Upsert Intercom contacts, start conversations, and configure Fin AI agent handoff to human support via the Intercom REST API
developers.intercom.com/docs/references/rest-api · 6 steps · unrated
Create and organize Help Scout Docs knowledge-base collections and articles via the Docs API
developer.helpscout.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans