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:
Under Integrations > Connected Integrations > Intercom > App Configuration > Configure, 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 purple “Save Changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.
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.
Copy
Ask AI
// You can find your project ID in the Overview tab of any Integration// Authenticate the userparagon.authenticate(<ProjectId>, <UserToken>);// Create Contactawait paragon.request("intercom", "/contacts", { method: "POST", body: { "role": "user", "external_id": "25", "email": "[email protected]", "phone": "+1123456789", "name": "Hoban Washburn", "avatar": "https://example.org/128Wash.jpg", "last_seen_at": 1571069751, "signed_up_at": 1571069751, "owner_id": 127, "unsubscribed_from_emails": false, "custom_attributes": { "paid_subscriber": true, "monthly_spend": 155.5, "team_mates": 1 } }});// Query Contactsawait paragon.request("intercom", "/contacts", { method: "GET"});
Webhook triggers can be used to run workflows based on events in your users’ Intercom account. For example, you might want to trigger a workflow whenever new companies are created in Intercom to sync your users’ Intercom companies to your application in real-time.
You can find the full list of Webhook Triggers for Intercom below: