> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/integrations/integration-setup.md).

# Integration setup

Where integrations live in Jimo, who can connect them, the ways they connect, and how to map synced fields to Jimo attributes.

Most integrations are connected once per project, from Settings > Integrations. This page covers what every integration has in common, so each integration page can stay short.

## Where integrations live

Open [Settings > Integrations](https://i.usejimo.com/settings/integrations). The page has two tabs: **Connections**, with a card for each integration, and **Webhooks**. A connected card shows **Enabled**. Hover a card to see its button: **Enable** opens the setup page of an integration you have not connected yet, and **Configure** opens the settings page of a connected one.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FXgkDoId5DBCZ3CazLX3u%2FF2-01-settings-integrations.png?alt=media&amp;token=c8cbf7c6-42d9-4f56-a688-1a4f7e7c533d" alt="Settings > Integrations on the Connections tab, with the Webhooks tab next to it. A: Integrations in the settings menu. B: the Configure button that shows when you hover a connected card, here Segment (server-side), marked Enabled."><figcaption></figcaption></figure>

A few integrations are not set up from this page:

* **Embeds** (Arcade, Storylane, Figma, Maze, InVision, booking links): you paste a link in the experience you are building.
* **Slack for a survey**: you connect Slack once here, then pick channels in each survey's **Insights > Integrations** tab.
* **Crisp**: you install the Jimo plugin from the Crisp Marketplace, then sign in to Jimo from Crisp.

## Who can connect an integration

Connecting an integration needs a role with access to the Integrations settings. The four default roles are Admin, Contributor, Editor and Viewer, and they cannot be edited. An Admin can also create a custom role with the exact permissions needed. See [Roles and permissions](https://help.usejimo.com/docs/getting-started/your-workspace/roles-and-permissions.md).

{% hint style="info" %}
The MCP follows the same rule: a member without access to the Integrations settings cannot connect an AI assistant. See [MCP](https://help.usejimo.com/docs/integrations/mcp.md).
{% endhint %}

## How integrations connect

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FPNdSfxhzfHLdlaYM8vyZ%2FF2-50-five-ways-to-connect.png?alt=media&amp;token=cd0bd265-fabd-42a2-9f15-4e796cbe6a33" alt="Five ways integrations connect: sign in to the tool, turn on a direction, copy credentials, install from the tool, enter credentials, with the integrations of each"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Sign in to the tool" %}
HubSpot, Salesforce, Slack. Hover the card, click **Enable**, then connect from the setup page: sign in to the tool, choose the account, and accept the permissions it asks for. You land back in Jimo on the integration's settings page.

Intercom: hover its card, click **Enable**, then connect from the setup page first, then add the Jimo app to the Messenger home in Intercom. See [Intercom](https://help.usejimo.com/docs/integrations/intercom.md).
{% endtab %}

{% tab title="Turn on a direction" %}
Amplitude, PostHog, Mixpanel, Heap. Hover the card, click **Enable**, then connect from the setup page and turn on each direction you need in the integration settings: Jimo to the tool, the tool to Jimo, or both.
{% endtab %}

{% tab title="Copy credentials" %}
Segment (server-side), Zapier, Server-side events. Jimo generates an API key on the integration's settings page. Copy it and paste it in the other tool, or in your backend's request headers.

REST API: click **Enable** on the API card, then copy the API Client and API Secret. See [API](https://help.usejimo.com/docs/for-developers/for-developers/api.md).

Treat the key like a password: never paste it in a ticket, a chat or an email.
{% endtab %}

{% tab title="Install from the tool" %}
Segment (client-side), Crisp. The integration is added from the other tool: the Segment catalog, the Crisp Marketplace.
{% endtab %}

{% tab title="Enter credentials" %}
Zendesk Knowledge. Hover the card, click **Enable**, then click **Connect Zendesk** on the setup page and sign in to Zendesk as an agent or admin, then run **Test connection**. Setups that use a Zendesk subdomain, email and API token keep working until Zendesk switches API tokens off on 30 April 2027. See [Zendesk Knowledge](https://help.usejimo.com/docs/integrations/zendesk-knowledge.md).
{% endtab %}
{% endtabs %}

## Map synced fields to attributes

CRM integrations (HubSpot, Salesforce) copy fields from the tool onto Jimo users. They follow the same pattern.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FibKep9Nvr34HstbvmAsU%2FF2-51-mapping-pattern.png?alt=media&amp;token=7489a9eb-80c1-4f08-b69b-18fd760e39cd" alt="Three steps: match the CRM record to an existing Jimo user on the same email or user ID, map each CRM field to a Jimo attribute, then run a full sync to fill past values. A record with no match is skipped"><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Pick the matching field

Choose the field that identifies the same person in both tools. Email is the default. You can use the user ID you send to Jimo with identify instead, as long as the same value exists as a property in the other tool.
{% endstep %}

{% step %}

### Map each field to a Jimo attribute

For each field you want in Jimo, select an existing attribute on the right side. To create a new attribute, type its name and press Enter: the field shows a small **Press enter to create** hint. Do not press Enter on an empty field, it creates an attribute with no name.
{% endstep %}

{% step %}

### Run a full sync

New mappings do not fill past values on their own. Run a full sync to populate the attributes of your existing users.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
These integrations update users that already exist in Jimo. They never create users. A record with no match in Jimo is skipped.
{% endhint %}

Synced attributes appear on the user profile with the tool's icon. Manage them with your other attributes in [Attributes](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes.md).

## Disconnect an integration

Open the integration's settings page from its card and use its disconnect or delete button. The sync stops right away.

## Verify

* The card shows **Enabled** in [Settings > Integrations](https://i.usejimo.com/settings/integrations), and **Configure** when you hover it.
* For an inbound integration, open a known user in [Users](https://help.usejimo.com/docs/analyze/users-and-segments/audience/users.md): synced attributes carry the tool's icon, and incoming events are listed in [Success Tracker > Events](https://help.usejimo.com/docs/analyze/success-tracker/events.md). The list shows each event once, with its **Source** and when it was **Last received at**, not a history over time: to follow an event over time, create a feature usage [tracker](https://help.usejimo.com/docs/analyze/success-tracker/trackers.md).
* For an outbound integration, trigger the experience yourself and check that the destination received it.

## Go further

* [Integrations](https://help.usejimo.com/docs/integrations/integrations-list.md): every integration, by family.
* [Attributes and events](https://help.usejimo.com/docs/getting-started/install-jimo/attributes-and-events.md): what is worth syncing.
* [Create a custom attribute](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes/create-a-custom-attribute.md): prepare attributes before the first sync.

**Next page:** [MCP](https://help.usejimo.com/docs/integrations/mcp.md)
