I'm syncing documentation from Notion to Intercom and I’m looking for a better way to handle internal and public articles.
Current workflow:
All documentation is written in Notion.
I use Intercom’s native Notion sync, but it only creates internal articles.
I then use Make.com to read those internal articles via Intercom APIs and create/update public articles with the same title and body.
I'd like to also copy the tags from the internal articles, but I can't find a way to access them through the API.
My questions:
Is it possible to retrieve the tags assigned to internal articles via the API or any other method?
Is there a better or more official way to convert internal articles into public ones while preserving metadata like tags?
Any guidance or recommended approaches would be appreciated!
Best answer by Paul Byrne
Het @Andre Romao Paul here from support engineering to help you out 🤝
The /api/v3/internal_articles endpoint currently does not expose tags in its API response. While internal articles have tag support in the underlying data model, the V3 REST API presenter only returns these fields:
id
title
body
owner_id
author_id
locale
created_at
updated_at
The V3 Internal Articles API (which OAuth apps use) intentionally limits the fields returned compared to what's available internally. Tags are stored but not exposed through the public OAuth API endpoint.Alternative approaches:
Feature Request: This appears to be an intentional API design limitation. The standard /api/v3/articles endpoint (for public Help Center articles) DOES include tags..
Use Intercom's native sync differently: Instead of creating internal articles first, consider:
Syncing Notion → Public articles directly
Using article visibility/audience targeting rules to control who sees them
This would give you access to tags through the /api/v3/articles endpoint
Workaround limitation: Unfortunately, there's no official way to retrieve internal article tags through the OAuth API. The Ember API (used by Intercom's internal UI) does include tags, but it's not accessible to OAuth apps.
Het @Andre Romao Paul here from support engineering to help you out 🤝
The /api/v3/internal_articles endpoint currently does not expose tags in its API response. While internal articles have tag support in the underlying data model, the V3 REST API presenter only returns these fields:
id
title
body
owner_id
author_id
locale
created_at
updated_at
The V3 Internal Articles API (which OAuth apps use) intentionally limits the fields returned compared to what's available internally. Tags are stored but not exposed through the public OAuth API endpoint.Alternative approaches:
Feature Request: This appears to be an intentional API design limitation. The standard /api/v3/articles endpoint (for public Help Center articles) DOES include tags..
Use Intercom's native sync differently: Instead of creating internal articles first, consider:
Syncing Notion → Public articles directly
Using article visibility/audience targeting rules to control who sees them
This would give you access to tags through the /api/v3/articles endpoint
Workaround limitation: Unfortunately, there's no official way to retrieve internal article tags through the OAuth API. The Ember API (used by Intercom's internal UI) does include tags, but it's not accessible to OAuth apps.
