Authenticate with 'Bearer YOUR_TOKEN' in the Authorization header.
List available Help Centers and their collections with GET /help_center/help_centers and GET /help_center/collections to identify the parent collection for your new article.
Create a draft article with POST /articles, supplying 'title', 'body' (HTML content), 'author_id' (a valid admin ID), and optionally 'parent_id' and 'parent_type' (collection or section) to nest it.
Review the created article by fetching it with GET /articles/{article_id} — the 'state' field will be 'draft'.
Publish the article by sending a PATCH to /articles/{article_id} with 'state': 'published' in the request body.
Translate the article for additional locales by creating locale-specific content via the 'translated_content' field in a PATCH request, supplying locale codes and localized title/body.
Known gotchas
The 'author_id' must be an existing Intercom admin (team member) ID — using a contact or bot ID will result in a validation error.
HTML in the article body is sanitized by Intercom — complex or non-standard HTML elements may be stripped; test with a representative sample before bulk importing content.
Deleting a collection does not automatically delete its articles — orphaned articles remain and must be deleted or re-parented individually.
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