Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

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 apiKey in 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?

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	Drift API bearer token (from Settings > Integrations > API & SDKs)
`operation`	string	yes	—	One of: list-contacts, get-contact, create-contact, list-messages, send-message
`contactId`	string	no	—	Drift contact ID (for get-contact)
`email`	string	no	—	Email address (for list-contacts filter or create-contact)
`limit`	string	no	—	Maximum number of results to return (for list-contacts)
`conversationId`	string	no	—	Drift conversation ID (for list-messages and send-message)
`messageBody`	string	no	—	Text of the message to send (for send-message; rendered as HTML)
`userId`	string	no	—	Drift user ID to send the message as (for send-message; defaults to bot user)