Drift
Manage conversations, contacts, and messages in Drift conversational support.
What it does
Provides five operations against the Drift REST API (https://driftapi.com):
| Operation | Description |
|---|---|
list-contacts |
List contacts, optionally filtered by email address |
get-contact |
Retrieve a single contact by its Drift ID |
create-contact |
Create a new contact (email required) |
list-messages |
Retrieve messages from a conversation (pages of 50) |
send-message |
Post a chat message into an existing conversation |
API Key Setup
Drift uses bearer-token authentication.
- Log into Drift and go to Settings > Integrations > API & SDKs.
- Create or copy your Access Token.
- Pass it as
apiKeyin every tool call.
The token is sent as Authorization: Bearer <apiKey> on every request.
Inputs
| Field | Required | Description |
|---|---|---|
apiKey |
Yes | Drift bearer token |
operation |
Yes | One of the five operations above |
contactId |
For get-contact |
Numeric Drift contact ID |
email |
For list-contacts / create-contact |
Email address to search or assign |
limit |
Optional | Max results for list-contacts |
conversationId |
For list-messages / send-message |
Numeric conversation ID |
messageBody |
For send-message |
Message text (rendered as HTML in Drift) |
userId |
Optional | Drift user ID to send the message as; defaults to bot user |
Outputs
| Field | Description |
|---|---|
result |
JSON string containing the Drift API response |
status |
ok on success, error on failure |
Examples
Search contacts by email
operation: list-contacts
email: [email protected]
Create a new contact
operation: create-contact
email: [email protected]
Get a specific contact
operation: get-contact
contactId: 15811408544
List messages in a conversation
operation: list-messages
conversationId: 98765
Send a message
operation: send-message
conversationId: 98765
messageBody: Hello! How can I help you today?