Intercom

Setup Guide
Note: You'll need to create a new Intercom app if you don't already have one. To access your customer's Intercom data by using OAuth, you'll need to submit your app for a review.
You can find your Intercom app credentials by visiting your Intercom Developer Hub.
You'll need the following information to set up your Intercom App with Paragon Connect:
Client ID
Client Secret
Add the Redirect URL to your Intercom app
Paragon provides a redirect URL to send information to your Intercom app. To add the redirect URL to your Intercom app:
1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:
1
https://passport.useparagon.com/oauth
Copied!
2. In your Intercom developer dashboard, select your application.
3. Under Configure > Authentication, click the Edit button.
4. Tick the Use OAuth option.
5. Under Redirect URLs, paste-in Paragon Connect's redirect URL found in Step 1. Click the Save button to save your changes.
Add your Intercom app to Paragon
1. Select Intercom from the Integrations Catalog.
2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from the end of Step 1 in their respective sections:
Client ID: Found under Configure > Basic Information > Client ID on your Intercom app page.
Client Secret: Found under Configure > Basic Information > Client Secret on your Intercom app page.
Press the blue "Connect" button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.
Connecting to Intercom
Once your users have connected their Intercom account, you can use the Paragon SDK to access the Intercom API on behalf of connected users.
See the Intercom REST API documentation for their full API reference.
Any Intercom API endpoints can be accessed with the Paragon SDK as shown in this example.
1
// You can find your project ID in the Overview tab of any Integration
2
​
3
// Authenticate the user
4
paragon.authenticate(<ProjectId>, <UserToken>);
5
            
6
// Create Contact
7
await paragon.request("intercom", "/contacts", { 
8
  method: "POST",
9
  body: {
10
    "role": "user",
11
	  "external_id": "25",
12
	  "email": "[email protected]",
13
    "phone": "+1123456789",
14
    "name": "Hoban Washburn",
15
    "avatar": "https://example.org/128Wash.jpg",
16
    "last_seen_at": 1571069751,
17
    "signed_up_at": 1571069751,
18
    "owner_id": 127,
19
    "unsubscribed_from_emails": false,
20
    "custom_attributes": {
21
      "paid_subscriber": true,
22
      "monthly_spend": 155.5,
23
      "team_mates": 1
24
    }
25
  }
26
});
27
​
28
// Query Contacts
29
await paragon.request("intercom", "/contacts", { 
30
  method: "GET"
31
});
32
  
Copied!
Building Intercom workflows
Once your Intercom account is connected, you can add steps to perform the following actions:
Create contact
Update contact
Get contact by ID
Search contacts
Send message
When creating or updating contacts in Intercom, you can reference data from previous steps by typing {{ to invoke the variable menu.

HubSpot

Jira

Last modified 7mo ago

Copy link

Contents

Setup Guide

Add the Redirect URL to your Intercom app

Add your Intercom app to Paragon

Connecting to Intercom

Building Intercom workflows