Create an article
Example Request & Response (Multilingual Help Center)
$ curl https://api.intercom.io/articles \\-X POST \\-H 'Authorization:Bearer <Your access token>' \\-H 'Accept:application/json'-H 'Content-Type: application/json' -d{ \"title\": \"Thanks for everything\", \"description\": \"English description\", \"body\": \"<p>This is the body in html</p>\", \"author_id\": 1, \"state\": \"published\", \"parent_id\": 1, \"parent_type\": \"collection\", \"translated_content\": { \"fr\": { \"title\": \"Allez les verts\", \"description\": \"French description\", \"body\": \"<p>French body in html</p>\", \"author_id\": 1, \"state\": \"published\" } }}
You can create a new article by making a POST request to https://api.intercom.io/articles.
Request Body Parameters
| Key | Type | Required? | Description |
|---|---|---|---|
| title | String | Yes | The title of the article. For multilingual articles, this will be the title of the default language's content. |
| description | String | No | The description of the article. For multilingual articles, this will be the description of the default language's content. |
| body | String | No | The body of the article in HTML. For multilingual articles, this will be the body of the default language's content. |
| author_id | String | Yes | 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. |
| state | String | No | 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. |
| parent_id | String | No | The id of the article's parent collection or section. An article without this field stands alone. |
| parent_type | String | No | The type of parent, which can either be a collection or section. |
| translated_content | Object | No | An Article Translated Content Object whereby you can specify multiple multilingual articles to be created. |
Response
This will return an Article object of the article you just created.