Skip to main content

Embed Advocacy in Gainsight Communities

T
Written by Tom Aristone
Updated today

Embed your UE Advocacy hub directly inside a Gainsight Communities page so members can complete missions, earn rewards, and track their activity — without leaving your community.

Before you start: you'll need admin access to both your Gainsight Communities workspace and your UE Advocacy admin panel.


Part 1 — Admin setup (one-time)

  1. In Gainsight, go to Integrations → Connectors and add a new API connection using this URL: https://api.joinzealot.com/embed/overview

  2. In the UE Advocacy admin panel, go to Integrations and click "Learn More" next to the Gainsight integration. Copy your Brand ID from that page.

  3. Back in Gainsight, add the following query parameters to your API connection:

    • email → {{ user.email }}

    • brandId → [paste your Brand ID here]

  4. Navigate to the page where you want to embed the hub. Edit the page (or add a new tab), click Other → HTML Widget, and paste this script:

<div id="widget-container"></div> <script src="https://static.customer-hub.northpass.com/widget-sdk/latest/index.umd.js"></script> <script> (async () => {   const sdk = new window.WidgetServiceSDK();   const result = await sdk.connectors.execute({     permalink: "zealot",     method: "GET"   });   const container = document.getElementById('widget-container');   if (result?.iframe && typeof result.iframe === 'string') {     container.innerHTML = result.iframe;   } else {     console.warn('Unexpected result format:', result);     container.textContent = 'Unable to display widget.';   } })(); </script>

5. Click Done, then Publish. The advocacy hub will now appear embedded for all community members.


Part 2 — What members will see

Once the widget is live, members will see the full advocacy hub embedded directly in the page — no separate login required. They can browse and complete missions, track points and rewards, submit referrals and reference requests, and access their personalized advocate dashboard.

The embed uses each member's community email to automatically authenticate them into the hub.


Questions? Reach out to your UserEvidence customer success manager or email [email protected]

Did this answer your question?