> ## 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.

# Four/Four

## What's supported

### Supported actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill. Please note that incremental reading is only supported for `Insights`, `Topics`, `TopicModels`, `Chats`, `ChatMessages`, `Accounts`, `Contacts`, `Cases`, `Calls`, `Owners`, `Opportunities`, `Leads`, `Objects`, `TrackerProjects`, `TrackerIssues`, and `TrackerComments`. For all other objects, a full read of the Four/Four instance will be done per scheduled read.
* [Proxy Actions](/proxy-actions), using the base URL `https://fourfour.ai`.

### Supported objects

The Four/Four connector supports reading from the following objects:

* [Accounts](https://fourfour.ai/developers/api#tag/Accounts/paths/~1Accounts/get) (supports incremental read)
* [CalendarEvents](https://fourfour.ai/developers/api#tag/CalendarEvents/paths/~1CalendarEvents/get)
* [Cases](https://fourfour.ai/developers/api#tag/Cases/paths/~1Cases/get) (supports incremental read)
* [Calls](https://fourfour.ai/developers/api#tag/Calls/paths/~1Calls/get) (supports incremental read)
* [ChatMessages](https://fourfour.ai/developers/api#tag/ChatMessages/paths/~1ChatMessages/get) (supports incremental read)
* [Chats](https://fourfour.ai/developers/api#tag/Chats/paths/~1Chats/get) (supports incremental read)
* [Contacts](https://fourfour.ai/developers/api#tag/Contacts/paths/~1Contacts/get) (supports incremental read)
* [Conversations](https://fourfour.ai/developers/api#tag/Conversations/paths/~1Conversations/get)
* [Fragments](https://fourfour.ai/developers/api#tag/Fragments/paths/~1Fragments/get)
* [Insights](https://fourfour.ai/developers/api#tag/Insights/paths/~1Insights/get) (supports incremental read)
* [Labels](https://fourfour.ai/developers/api#tag/Labels/paths/~1Labels/get)
* [Leads](https://fourfour.ai/developers/api#tag/Leads/paths/~1Leads/get) (supports incremental read)
* [Objects](https://fourfour.ai/developers/api#tag/Objects/paths/~1Objects/get) (supports incremental read)
* [Opportunities](https://fourfour.ai/developers/api#tag/Opportunities/paths/~1Opportunities/get) (supports incremental read)
* [Owners](https://fourfour.ai/developers/api#tag/Owners/paths/~1Owners/get) (supports incremental read)
* [Participants](https://fourfour.ai/developers/api#tag/Participants/paths/~1Participants/get)
* [TopicModels](https://fourfour.ai/developers/api#tag/TopicModels/paths/~1TopicModels/get) (supports incremental read)
* [Topics](https://fourfour.ai/developers/api#tag/Topics/paths/~1Topics/get) (supports incremental read)
* [TrackerComments](https://fourfour.ai/developers/api#tag/TrackerComments/paths/~1TrackerComments/get) (supports incremental read)
* [TrackerIssues](https://fourfour.ai/developers/api#tag/TrackerIssues/paths/~1TrackerIssues/get) (supports incremental read)
* [TrackerProjects](https://fourfour.ai/developers/api#tag/TrackerProjects/paths/~1TrackerProjects/get) (supports incremental read)

### Example integration

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

## Before you get started

To connect *Four/Four* with *Ampersand*, you will need a [Four/Four account](https://fourfour.ai).

Once your account is ready, you'll need to create a Four/Four OAuth2 app and obtain the following credentials:

* Client ID
* Client Secret

### Creating a Four/Four app

1. [Sign in](https://fourfour.ai/login) to your Four/Four account as an admin user.
2. Go to **Settings** > **Connections** > **OAuth clients**.
3. Click **ADD CLIENT** and fill in the form.
4. Under **Redirect URI**, add the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`.
5. Save your app settings.
6. Copy the generated **Client ID** and **Client Secret**.

## Add your Four/Four 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 Four/Four 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 *Four/Four* 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/2UgBHsBIMYe0kogs/images/provider-guides/fourfour-amp.gif?s=cd88f58a6be9effdceff0d9d76e3b858" alt="Alt text" width="1234" height="1276" data-path="images/provider-guides/fourfour-amp.gif" />

6. Click **Save changes**.

## Using the connector

To start integrating with Four/Four:

* Create a manifest file like the [example](https://github.com/amp-labs/samples/blob/main/fourfour/amp.yaml).
* Deploy it using the [amp CLI](/cli/overview).
* If you are using Read Actions, create a [destination](/destinations).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component prompts the customer for OAuth authorization.
* Start using the connector.
  * If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
  * If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.