> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Drift

## What's Supported

### Supported Actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill. Please note that incremental read is not supported, a full read of the Drift instance will be done for each scheduled read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://driftapi.com`.

### Supported Objects

The Drift connector supports reading from the following objects:

* [users](https://devdocs.drift.com/docs/listing-users)
* [conversations](https://devdocs.drift.com/docs/list-conversations)
* [teams/org](https://devdocs.drift.com/docs/listing-teams-org)
* [users/meetings/org](https://devdocs.drift.com/docs/get-booked-meetings)
* [playbooks](https://devdocs.drift.com/docs/get-playbooks)
* [playbooks/clp](https://devdocs.drift.com/docs/retrieve-conversational-landing-pages)
* [conversations/stats](https://devdocs.drift.com/docs/bulk-conversation-statuses)
* [scim/Users](https://devdocs.drift.com/docs/searching)

The Drift connector supports writing to the following objects:

* [contacts](https://devdocs.drift.com/docs/creating-a-contact)
* [contacts/timeline](https://devdocs.drift.com/docs/posting-timeline-events)
* [emails/unsubscribe](https://devdocs.drift.com/docs/unsubscribe-contacts-from-emails)
* [conversations](https://devdocs.drift.com/docs/creating-a-conversation)
* [accounts/create](https://devdocs.drift.com/docs/creating-an-account)
* [accounts/update](https://devdocs.drift.com/docs/updating-accounts)
* [scim/Users](https://devdocs.drift.com/docs/searching)

### Example integration

For an example manifest file of an Apollo integration, visit our [samples repo on Github](https://github.com/amp-labs/samples/blob/main/drift/amp.yaml).

## Before You Get Started

To integrate Drift with Ampersand, you will need [a Drift Account](https://app.drift.com/signup).

Once your account is created, you'll need to create an app in Drift, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

* Client ID
* Client Secret

You will then use these credentials to connect your application to Ampersand.

### Create a Drift Account

Here's how you can sign up for a Drift account:

* Go to the [Drift Sign Up page](https://app.drift.com/signup).
* Sign up using your preferred method.

### Creating a Drift App

Follow the steps below to create a Drift app and add the Ampersand redirect URL.

1. Log in to your [Drift](https://app.drift.com/login) account.

2. Navigate to the [Drift Developer Portal](https://dev.drift.com/).

3. Click the **Build Your App** button under Your Apps to create a new app.

4. Enter the app details in the **Display Information** section, including the app's name, description, and icon..

<img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/db48d9d-drift1.gif?s=13f68546e00c0d785147f8757f50d03f" alt="Alt text" width="1440" height="676" data-path="images/provider-guides/db48d9d-drift1.gif" />

5. Go to the **OAuth and Scopes** section.
6. In the **Allowed Oauth Redirect URIs** section, enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`.
7. Click **Add**.
8. Select the necessary permission scopes to your app from the **Drift Scopes** section.

<img src="https://mintcdn.com/ampersand-24eb5c1a/p4alBfPjHeNuBPh1/images/provider-guides/00f2e5c-drift2.gif?s=27f15e35ebd53fc68366e933e21089dc" alt="Alt text" width="1440" height="676" data-path="images/provider-guides/00f2e5c-drift2.gif" />

9. Under the **Activate Your App** section, click the **Install App to Drift** button.

You app is now ready to connect to Ampersand.

The **App Credentials** section displays **Client ID** and **Client Secret** keys for your app. You'll use these credentials to connect your app to [Ampersand](https://docs.withampersand.com/docs/drift#add-your-drift-app-info-to-ampersand).

## Add Your Drift App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Drift integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Alt text" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider Apps**.

4. Select *Drift* from the **Provider** list.

5. Enter the previously obtained *Client ID* in the **Client ID** field and the *Client Secret* in the **Client Secret** field.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/71f5b30-drift4.gif?s=ae46266f5e38bd0855e363f854113154" alt="Alt text" width="812" height="586" data-path="images/provider-guides/71f5b30-drift4.gif" />

6. Click **Save Changes**.
