Retrieve existing collections via GET /help_center/collections to get collection IDs and their parent_id hierarchy.
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.
To publish a draft article, PATCH /articles/{article_id} with 'state': 'published'.
To update article content, PATCH /articles/{article_id} with 'title' and/or 'body'; the response returns the updated article.
Delete an article with DELETE /articles/{article_id}; this is permanent and the URL becomes a 404 immediately.
List all articles in a collection: GET /articles?help_center_id={id} or by filtering on parent_id in the results.
Known gotchas
The 'author_id' must be a valid admin ID in the Intercom workspace — using an invalid or deleted admin ID returns a 422 error.
Article body HTML is partially sanitized by Intercom — certain tags and inline styles may be stripped; test with a representative sample before automating bulk article creation.
Intercom Help Center has a single workspace-level Help Center; if the workspace has multiple Help Centers (available on certain plans), specify 'help_center_id' to target the correct one.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp