Integrating Drift
Auth: OAuth 2.0 · Partner program: not required · Setup time: about 20 minutes · Last verified: 2026-05-23
Drift is a B2B conversational marketing + live-chat platform (now part of Salesloft). The adapter wraps the Drift REST API and surfaces conversations, contacts, and users into the canonical customer-support schema.
Auth model
Section titled “Auth model”- OAuth 2.0 Authorization Code grant. Authorize at
https://dev.drift.com/authorize. Exchange via POST tohttps://driftapi.com/oauth2/token. - Access tokens expire after
7200seconds (2 hours). The response includes arefresh_token(long-lived) and anorgIdidentifying the installed organization — store it alongside the credential.
Prerequisites
Section titled “Prerequisites”- A Drift account with admin access at app.drift.com.
- A registered app in Drift’s developer console at dev.drift.com. Note your Client ID and Client Secret and add a redirect URI.
Configure in admin
Section titled “Configure in admin”- Open
/platformsin the admin UI, filter to Customer Support, click Drift. - Fill Configure:
clientId— from the Drift developer console.clientSecret— from the Drift developer console.redirectUri—${PUBLIC_BASE_URL}/auth/customer-support/drift/callback.
- Enable the adapter.
Required scopes
Section titled “Required scopes”Drift declares scopes statically in the developer console. Once a token is issued you cannot widen them without re-installing the app. Request:
contact_read,contact_write— contacts.conversation_read,conversation_write— conversations + messages.user_read— agents / teammates.
gdpr_read / gdpr_write are only needed if you intend to drive subject-access workflows through the adapter.
Webhooks
Section titled “Webhooks”Drift webhooks are configured per-app in the developer console. Each delivery is signed with HMAC-SHA256 using your app’s client secret; verify against the X-Drift-Signature header (base64). Subscribe to:
new_message,new_conversationconversation_status_changedcontact_created,contact_updated
Quirks worth knowing
Section titled “Quirks worth knowing”- One token per org. The
orgIdin the token response is canonical — Drift does not let one token operate against multiple organizations. - Scopes are immutable. Adding a new scope to an existing app requires every install to re-authorize; Drift will not silently top up the granted scope set.
- Drift is being consolidated into Salesloft. The
driftapi.comhost and developer console remain available as of mid-2026, but expect URL changes during the migration — pin a feature flag if you need to switch hosts later.
References
Section titled “References”opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.