How can I build my own checklist UI on my page? | Community
Skip to main content
Question

How can I build my own checklist UI on my page?

  • November 27, 2025
  • 2 replies
  • 7 views

We’re Intercom customers and we need to build a variation of the checklist on our own page, not inside the Messenger widget. I assumed the most obvious solution would be to consume an API that returns these checklists, similar to how it works with articles.

 

Do we have anything like that? I couldn’t find it in the documentation.
This is very important for us!

2 replies

Paul Byrne
Intercom Team
Forum|alt.badge.img+6
  • Intercom Team
  • November 27, 2025

Hey ​@Lorenzo Aceti Paul here from support engineering to help you out 🤝 

I recommend the following :

  1. Create the checklist content in Intercom where appropriate (Outbound / Help Center). See the Help Center article: https://www.intercom.com/help/en/articles/6661022-design-your-checklist

  2. On your page implement the checklist UI (HTML/CSS/JS) and host it on your site.

  3. Track task completions with Intercom’s supported mechanisms:

    • JavaScript: Intercom('trackEvent', 'checklist_task_completed', { checklist_id: '...', task_id: '...' }) (client side).

    • Or server: POST to Intercom Events (server-to-server) to record completions if you prefer secure server calls. (Use the Events API / developer docs in your workspace to find the exact REST path and auth token.)

  4. Use the Events in Intercom to create segments, rules, or to update user attributes that you then use for automation/automation messages.

Why: fully supported, stable, and you control UX and auth.


  • Author
  • New Participant
  • November 27, 2025

But that’s not what I need. I need to be able to build a UI on a specific page, outside the Intercom widget, while still creating and managing the checklist through Intercom’s SaaS.

For that, I would need an API to fetch this checklist.