Search Contacts
drift.list_contacts
ActionCRM & salesconnection required
Calls the Drift API with the connection's credentials.
Find contacts by email address or by your own external id. Email is not unique in Drift, so this always emits an array.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Drift
- Secret shape
- {"client_id": "…", "client_secret": "…", "refresh_token": "…"}, or {"access_token": "…"} for an Install-to-Drift token
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
3 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
email The contact's email address. | string | No | — | email format | ada@example.com |
external_id Your own identifier for this person; Drift de-duplicates on it instead of the email address when it is set. | string | No | — | — | USER-143 |
limit Greatest number of contacts Drift should return. | number | No | — | ≥ 1 | — |
- At least one of email, external_id must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"email": "ada@example.com",
"external_id": "USER-143"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
contacts The matching contacts, each with id and attributes. | array | — |
count How many contacts matched. | number | — |
{
"contacts": [],
"count": 0
}Related Drift nodes
See Search Contacts run in a workflow.
In a technical demo we add the Drift connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.