Accessing internal article tags & better ways to convert internal → public articles | Community
Skip to main content
Question

Accessing internal article tags & better ways to convert internal → public articles

  • December 10, 2025
  • 1 reply
  • 7 views
A

I'm syncing documentation from Notion to Intercom and I’m looking for a better way to handle internal and public articles.

Current workflow:

  1. All documentation is written in Notion.

  2. I use Intercom’s native Notion sync, but it only creates internal articles.

  3. I then use Make.com to read those internal articles via Intercom APIs and create/update public articles with the same title and body.

  4. 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!

    1 reply

    Paul Byrne
    Intercom Team
    Forum|alt.badge.img+7
    • Paul ByrneIntercom Team
    • Intercom Team
    • December 11, 2025

    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:
    1. 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..
    1. 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
    1. 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.
    I will forward a feature request for you.
    Terms & ConditionsAccessibility statement