{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can create a new article by making a POST request to `https://api.intercom.io/articles`.\n\n> \uD83D\uDCD8 Tags are managed separately\n>\n> Tags are returned in article responses but cannot be set in the request body. To add or remove an article's tags, use the `POST /articles/{article_id}/tags` and `DELETE /articles/{article_id}/tags/{id}` endpoints.\n\nRequires the `read_write_articles_scope` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"body":{"$ref":"#/definitions/create_article_request","examples":[{"title":"Thanks for everything","description":"Description of the Article","body":"Body of the Article","author_id":991267497,"state":"published","parent_id":145,"translated_content":{"fr":{"title":"Merci pour tout","description":"Description de l'article","body":"Corps de l'article","author_id":991267497,"state":"published"}}}]}},"required":[],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]},"create_article_request":{"description":"You can create an Article","type":["object","null"],"title":"Create Article Request Payload","properties":{"title":{"type":"string","description":"The title of the article. For multilingual articles, this will be the title of the default language's content. Required unless a title is provided in `translated_content` under the workspace's default Help Center locale.","examples":["Thanks for everything"]},"description":{"type":"string","description":"The description of the article. For multilingual articles, this will be the description of the default language's content.","examples":["Description of the Article"]},"body":{"type":"string","description":"The content of the article in HTML. For multilingual articles, this will be the body of the default language's content. Mutually exclusive with `body_markdown`.","examples":["<p>This is the body in html</p>"]},"body_markdown":{"type":"string","description":"The content of the article in markdown. For multilingual articles, this will be the body of the default language's content. An alternative to `body` — you can provide content as markdown instead of HTML. Mutually exclusive with `body`.","examples":["# Hello\n\nA paragraph with **bold** text.\n"]},"author_id":{"type":"integer","description":"The id of the author of the article. For multilingual articles, this will be the id of the author of the default language's content. Must be a teammate on the help center's workspace. Required unless an `author_id` is provided in `translated_content` under the workspace's default Help Center locale.","examples":[1295]},"state":{"type":"string","description":"Whether the article will be `published` or will be a `draft`. Defaults to draft. For multilingual articles, this will be the state of the default language's content.","enum":["published","draft"],"examples":["draft"]},"parent_id":{"type":"integer","description":"The id of the article's parent collection or section. An article without this field stands alone.","examples":[18]},"parent_ids":{"type":"array","description":"The ids of the parent collections to place this article in. Send an empty array to leave the article without a collection. When provided, this takes precedence over `parent_id`.","items":{"type":"integer"},"examples":[[18,19]]},"locale":{"type":"string","description":"The locale of the article's default content, for example `en`. Defaults to the locale of the help center that the parent collection belongs to when `parent_id` is sent, and otherwise to the default Help Center locale. Must be a locale supported by the workspace's Help Center.","examples":["en"]},"translated_content":{"$ref":"#/definitions/article_translated_content"},"folder_id":{"type":["integer","null"],"description":"The ID of the folder to place this article in, or null to leave it without a folder.","examples":[6]},"audience_ids":{"type":["array","null"],"description":"The list of audience IDs to assign to this article for Fin AI Agent targeting. Sending a top-level `audience_ids` broadcasts the same set to every locale. For per-locale targeting, use `translated_content.<locale>.audience_ids` instead. Sending both top-level and per-locale in the same request causes top-level to win. Unknown audience IDs return a 404 error. No partial commit occurs.","items":{"type":"integer"},"examples":[[1,2]]},"ai_chatbot_availability":{"type":"boolean","description":"Whether the article should be available for AI Chatbot (Fin). For multilingual articles, this sets the default language's availability.","examples":[true]},"ai_copilot_availability":{"type":"boolean","description":"Whether the article should be available for AI Copilot. For multilingual articles, this sets the default language's availability.","examples":[true]},"ai_sales_agent_availability":{"type":"boolean","description":"Whether the article should be available for AI Sales Agent. For multilingual articles, this sets the default language's availability.","examples":[true]},"scheduled_publish_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp at which to schedule a future publish of the article. When set together with `state: \"published\"`, the article is scheduled instead of published immediately. Setting `null` cancels a pending publish schedule. Timestamps in the past or equal to the current time are rejected with 400 `parameter_invalid` — the value must be strictly in the future. Combining with `state: \"draft\"` returns 400 `parameter_invalid`. Sending in the same request as `scheduled_unpublish_at` returns 400 — only one pending schedule per article. Empty string returns 400 `parameter_invalid`.","examples":["2026-12-31T09:00:00Z"]},"scheduled_unpublish_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp at which to schedule a future unpublish of the article. The same request must also publish the article (`state: \"published\"`), otherwise it returns 400 `parameter_invalid`. The value must be strictly in the future; timestamps in the past or equal to the current time are rejected with 400 `parameter_invalid`. Setting `null` cancels a pending unpublish schedule. Sending in the same request as `scheduled_publish_at` returns 400 — only one pending schedule per article. Empty string returns 400 `parameter_invalid`.","examples":["2026-12-31T17:00:00Z"]}}},"article_translated_content":{"title":"Article Translated Content","type":["object","null"],"description":"The Translated Content of an Article. The keys are the locale codes and the values are the translated content of the article.","properties":{"type":{"type":["string","null"],"description":"The type of object - article_translated_content.","enum":[null,"article_translated_content"],"examples":["article_translated_content"]},"ar":{"$ref":"#/definitions/article_content"},"bg":{"$ref":"#/definitions/article_content"},"bs":{"$ref":"#/definitions/article_content"},"ca":{"$ref":"#/definitions/article_content"},"cs":{"$ref":"#/definitions/article_content"},"da":{"$ref":"#/definitions/article_content"},"de":{"$ref":"#/definitions/article_content"},"el":{"$ref":"#/definitions/article_content"},"en":{"$ref":"#/definitions/article_content"},"es":{"$ref":"#/definitions/article_content"},"et":{"$ref":"#/definitions/article_content"},"fi":{"$ref":"#/definitions/article_content"},"fr":{"$ref":"#/definitions/article_content"},"he":{"$ref":"#/definitions/article_content"},"hr":{"$ref":"#/definitions/article_content"},"hu":{"$ref":"#/definitions/article_content"},"id":{"$ref":"#/definitions/article_content"},"it":{"$ref":"#/definitions/article_content"},"ja":{"$ref":"#/definitions/article_content"},"ko":{"$ref":"#/definitions/article_content"},"lt":{"$ref":"#/definitions/article_content"},"lv":{"$ref":"#/definitions/article_content"},"mn":{"$ref":"#/definitions/article_content"},"nb":{"$ref":"#/definitions/article_content"},"nl":{"$ref":"#/definitions/article_content"},"pl":{"$ref":"#/definitions/article_content"},"pt":{"$ref":"#/definitions/article_content"},"ro":{"$ref":"#/definitions/article_content"},"ru":{"$ref":"#/definitions/article_content"},"sl":{"$ref":"#/definitions/article_content"},"sr":{"$ref":"#/definitions/article_content"},"sv":{"$ref":"#/definitions/article_content"},"tr":{"$ref":"#/definitions/article_content"},"vi":{"$ref":"#/definitions/article_content"},"pt-BR":{"$ref":"#/definitions/article_content"},"zh-CN":{"$ref":"#/definitions/article_content"},"zh-TW":{"$ref":"#/definitions/article_content"}}},"article_content":{"title":"Article Content","type":["object","null"],"description":"The Content of an Article.","properties":{"type":{"type":["string","null"],"description":"The type of object - `article_content` .","enum":[null,"article_content"],"examples":["article_content"]},"title":{"type":"string","description":"The title of the article.","examples":["How to create a new article"]},"description":{"type":"string","description":"The description of the article.","examples":["This article will show you how to create a new article."]},"body":{"type":"string","description":"The body of the article in HTML.","examples":["This is the body of the article."]},"body_markdown":{"type":["string","null"],"description":"The body of the article in markdown.","examples":["# How to create a new article\n\nThis is the body of the article.\n"]},"author_id":{"type":"integer","description":"The ID of the author of the article.","examples":["5017691"]},"state":{"type":"string","description":"Whether the article is `published` or is a `draft` .","enum":["published","draft"],"examples":["draft"]},"created_at":{"type":"integer","format":"date-time","description":"The time when the article was created (seconds).","examples":[1663597223]},"updated_at":{"type":"integer","format":"date-time","description":"The time when the article was last updated (seconds).","examples":[1663597260]},"has_unpublished_changes":{"type":"boolean","description":"Whether this locale's published content has unpublished changes staged as a draft on top of its live content.","examples":[false]},"draft_updated_at":{"type":["integer","null"],"format":"date-time","description":"The time, in seconds, when this locale's staged draft was last edited, or `null` when there is no staged draft.","examples":[1663597260]},"url":{"type":"string","description":"The URL of the article."},"audience_ids":{"type":["array","null"],"description":"The list of audience IDs this article content is targeted to for Fin AI Agent. On multilingual help centers this field appears per-locale inside `translated_content`. On single-language help centers it appears at the article root level. Empty array means no audience targeting is set.","items":{"type":"integer"},"examples":[[1,2]]},"ai_chatbot_availability":{"type":"boolean","description":"Whether the article is available for AI Chatbot.","examples":[true]},"ai_copilot_availability":{"type":"boolean","description":"Whether the article is available for AI Copilot.","examples":[true]},"ai_sales_agent_availability":{"type":"boolean","description":"Whether the article is available for AI Sales Agent.","examples":[true]}}}}},"name":"Create an article","id":"intercom.createarticle","example":{},"maxRequests":1,"summary":false}}