Intercom
Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.
Overview
Connect your Intercom account to Nirvai to automate customer conversations, manage contacts, and integrate support workflows.
Supported Authentication Methods
- Access Token - From an Intercom Developer App
Prerequisites
- An Intercom account with Admin access
- Access to the Intercom Developer Hub
Setup Instructions
Access Token (Developer App)
- Go to the Intercom Developer Hub
- Click Your apps in the top navigation
- Click New app (or select an existing app)
- Enter an app name (e.g., "Nirvai Integration")
- Select Internal integration (for your own workspace)
- Click Create app
- In the app settings, go to Authentication
- Your Access Token is automatically generated
- Copy the access token
- Paste the token in Nirvai
Access Token Permissions
When creating your app, you can configure which data it can access:
- Go to your app in Developer Hub
- Navigate to Authentication
- Scroll to Permissions
- Enable the required permissions for your use case
Required Permissions
| Permission | Description | Required For |
|---|---|---|
| Read one admin | Access admin info | Admin operations |
| Read all users/leads | Read contact data | Contact management |
| Write all users/leads | Create/update contacts | Contact sync |
| Read conversations | Access conversations | Conversation data |
| Write conversations | Send messages | Messaging automation |
| Read tags | Access tags | Tag management |
| Write tags | Create tags | Tagging automation |
Available Operations
With Intercom credentials, you can:
- Manage contacts (users and leads)
- Access and respond to conversations
- Create and manage tags
- Send messages and notifications
- Access visitor data
- Manage custom attributes
- Work with companies/organizations
Troubleshooting
Common Issues
- 401 Unauthorized: Token is invalid or revoked. Generate a new app token.
- 403 Forbidden: App lacks required permissions. Update app permissions.
- Rate Limiting: Intercom has strict rate limits. Implement backoff strategies.
- Workspace Access: Ensure the app is installed in the correct workspace.
Token Types
Intercom has different token types:
- Access Token: For server-side API access (use this in Nirvai)
- Client ID/Secret: For OAuth flows (not needed for Nirvai)
Finding Contact IDs
Intercom uses different ID types:
id: Intercom's internal IDuser_id: Your custom user identifieremail: User's email address
You can search by any of these.
API Versioning
Intercom uses API versioning. The integration uses the latest stable version. If you encounter issues, check the API changelog.
Related Resources
Adapted from n8n documentation for Nirvai platform
Next Steps
Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.