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

# HTTP

> Learn how to set up a HTTP destination connector in AI Squared to efficiently transfer data to your HTTP destination.

## Introduction

The Hyper Text Transfer Protocol (HTTP) connector is a method of transerring data over the internet to specific url endpoints. Integrating the HTTP Destination connector with AI Squared allows you to efficiently transfer your data to HTTP endpoints of your choosing. This guide outlines how to setup your HTTP destination connector in AI Squared.

### Destination Setup

<AccordionGroup>
  <Accordion title="Create an HTTP destination" icon="key" defaultOpen="true">
    <Steps>
      <Step title="Access AI Squared">
        Log in to your AI Squared account and navigate to the **Destinations** section to manage your data destinations.

        <Frame>
          <img src="https://res.cloudinary.com/dspflukeu/image/upload/v1716396869/http_dest_1.png" />
        </Frame>
      </Step>

      <Step title="Create a New Destination Connector">
        Click on the **Add Destination** button. Select **HTTP** from the list of available destination types.

        <Frame>
          <img src="https://res.cloudinary.com/dspflukeu/image/upload/v1716396869/http_dest_2.png" />
        </Frame>
      </Step>

      <Step title="Configure Connection Settings">
        Provide the following details to establish a connection between AI Squared and your HTTP endpoint:

        * **Destination Url**: The HTTP address of where you are sending your data.
        * **Headers**: A list of key value pairs of your choosing. This can include any headers that are required to send along with your HTTP request.
        * **Authentication Type**: Choose how AI Squared authenticates with your HTTP endpoint. Select `none` to skip authentication, or `oauth_client_credentials` to have AI Squared fetch and refresh an OAuth 2.0 access token automatically using the client credentials grant.

        When **Authentication Type** is set to `oauth_client_credentials`, provide the following additional fields:

        * **OAuth Token URL**: The token endpoint used to request access tokens (for example, `https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token`).
        * **OAuth Client ID**: The client ID issued by your identity provider.
        * **OAuth Client Secret**: The client secret issued by your identity provider.
        * **OAuth Scope**: Optional scope value sent with the token request (for example, `https://graph.microsoft.com/.default`).

        <Note>
          When OAuth client credentials are configured, AI Squared automatically attaches the retrieved access token as a `Bearer` token in the `Authorization` header on every request. Tokens are cached and refreshed before they expire, so you do not need to manage them manually.
        </Note>

        Enter these details in the respective fields on the connector configuration page and press **Finish**.

        <Frame>
          <img src="https://res.cloudinary.com/dspflukeu/image/upload/v1716396869/http_dest_3.png" />
        </Frame>
      </Step>

      <Step title="Test the Connection">
        After entering the necessary information, use the automated **Test Connection** feature to ensure AI Squared can successfully connect to your HTTP endpoint. If the test is successful, you'll receive a confirmation message. If not, double-check your entered details for any errors.
      </Step>

      <Step title="Finalize the Destination Connector Setup">
        After a successful connection test, save the connector settings to establish the destination connection.

        By following these steps, you've successfully set up an HTTP destination connector in AI Squared. You can now efficiently transfer data to your HTTP endpoint for storage or further distribution within AI Squared.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Accordion title="Supported Sync" icon="arrows-rotate" defaultOpen="true">
  | Mode             | Supported (Yes/No/Coming soon) |
  | ---------------- | ------------------------------ |
  | Incremental sync | Yes                            |
  | Full refresh     | No                             |
</Accordion>