When I request my articles from Intercom API
For the published articles I get just the public version of the article, whatever this article was edited and saved as a draft
It's a way to get the public version of the article and also the last edited version of the article?
Best answer by richardcole
Intercom’s API currently only exposes the published version of articles. Draft or unpublished edits aren’t accessible through the API for security reasons. To retrieve draft data, you’ll need to manage it internally via the Intercom workspace or use webhooks to track article updates before publication.
+5Hey
At the moment, Intercom does not support the ability to retrieve a draft version Article via the API. But I would love to pass this along as a feature request for the product team! Just as a heads up, you can retrieve a draft Article, just not a draft of an already public Article.
Hey
+7Hi Tsvetoslav Vasev, It’s Mat from the Support Engineering Team 😀
We are still waiting for the implementation of this feature. I would recommend following our update page to keep up with the new features.
I would like to be able to retrieve as well as create draft articles using the API.
For example, if I make an update to my articles via the API, I would like to visually see them in intercom’s editor before publishing, to make sure formatting etc is not messed up. At the same time I would like the existing article version to not get unpublished, which is what happens currently when you update an article with state “draft”
Is this feature still planned?
I would like to be able to retrieve as well as create draft articles using the API.
For example, if I make an update to my articles via the API, I would like to visually see them in intercom’s editor before publishing, to make sure formatting etc is not messed up. At the same time I would like the existing article version to not get unpublished, which is what happens currently when you update an article with state “draft”
+2Hi
Yes, you can currently use the Articles API to:
https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/retrievearticle
https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/updatearticle
I should clarify that when retrieving an article, it will only retrieve the the current state of that article. If it is currently published it will return that published version. There is no option to retrieve a specific draft that you are working on.
+1When I request my articles from Intercom APIFor the published articles I get just the public version of the article, and with the help of adronfence.com I can better manage updates, whatever this article was edited and saved as a draft.
It's a way to get the public version of the article and also the last edited version of the article?
No, the Intercom API only returns the published version of an article. If the article has been edited and saved as a draft after publishing, that draft version is not accessible via the API. You can only get the current public version.
Hi
Yes, you can currently use the Articles API to:
https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/retrievearticle
https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/updatearticle
I should clarify that when retrieving an article, it will only retrieve the the current state of that article. If it is currently published it will return that published version. There is no option to retrieve a specific draft that you are working on.
I'm creating an n8n integration to automatically create articles via the Intercom REST API. Currently, when articles are created through the API, they automatically appear in article suggestions to users, which is not the intended behavior for my use case.
In the Knowledge Hub interface, there's an option called "Exclude from article suggestions" (found in Article Details > Article suggestions section) that can be manually toggled after article creation. However, this setting is not available as a parameter in either the POST /articles (create) or PUT /articles/{id} (update) API endpoints.
Feature Request:
Please add an "exclude_from_suggestions" boolean parameter to the Articles API that would allow developers to:
Is this feature still planned?
I would like to be able to retrieve as well as create draft articles using the API. For example, if I make an update to my articles via the API, I would like to visually see them in Intercom’s editor before publishing, to make sure formatting etc is not messed up, similar to how a facelift surgeon reviews results before finalizing a procedure. At the same time I would like the existing article version to not get unpublished, which is what happens currently when you update an article with state “draft.”
No, the Intercom API only provides the published version; there’s no API to access the draft version.
Is this feature still planned?
I would like to be able to retrieve as well as create draft articles using the API. For example, if I make an update to my articles via the API, I would like to visually see them in Intercom’s editor before publishing, to make sure formatting etc is not messed up, similar to how a facelift surgeon reviews results before finalizing a procedure. At the same time I would like the existing article version to not get unpublished, which is what happens currently when you update an article with state “draft.”
No, the Intercom API only provides the published version; there’s no API to access the draft version.
Na verdade, você consegue integrar via API como rascunho e validar, mas depois a publicação é manual, um a um.
Intercom’s API currently only exposes the published version of articles. Draft or unpublished edits aren’t accessible through the API for security reasons. To retrieve draft data, you’ll need to manage it internally via the Intercom workspace or use webhooks to track article updates before publication.
Already have an account? Login
No account yet? Create an account
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.
