# Examples: Twitter and Giphy

## Using OAuth 2.0 to integrate Twitter

This example demonstrates how to create a custom authenticated integration with the Twitter API that uses OAuth 2.0 and connect it to an Airkit application.&#x20;

**Note**: When setting up an OAuth 2.0 integration in Airkit, a refresh token is expected, and the system/endpoint must be configured accordingly. Some systems will automatically account for this and some systems may not.&#x20;

### Prerequisites

* [Twitter developer account](https://developer.twitter.com/content/developer-twitter/en/docs/basics/developer-portal/overview)
* A [Twitter App](https://developer.twitter.com/content/developer-twitter/en/docs/basics/developer-portal/guides/apps) with a developer account

### Setting up your custom integration

1.  Sign in to [console.airkit.com](https://console.airkit.com) and select **Integrations** and then \*\*Custom Integrations.\*\*This is where to manage the integrations associated with an organization.

    ![cusromintsmall.png](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-515a65520cf95a1fb9bbb1f12af650bd1eb4c597%2Fsetting-up-integrations-v182-0.png?alt=media)
2. Then click on **Create new** to add a new Custom Integration. Enter the name of the service  and a unique key. This key is a global unique identifier associated with your custom integration. Then select OAuth 2.0 for the Authentication Type. This will then expand the fields that are required to create the integration.

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-d39f80ae63e51b2a1ab6aa7c3391e488a462ee89%2Fsetting-up-integrations-v182-1.png?alt=media)

3. For the [Twitter API](https://developer.twitter.com/en/docs), provide the following for the configuration fields:
   * **Authorization Grant Type:** choose 'Client Credentials'
   * **Access Token Endpoint:** enter [https://api.twitter.com/oauth2/token](https://api.twitter.com/oauth2/token)
   * **Access Token Verb:** choose 'POST'
   * **Authorization Endpoint:** enter [https://api.twitter.com/oauth2/token](https://api.twitter.com/oauth2/token)
   * **OAuth Scope:** enter 'read'
   * **Client ID:** enter your API key that was generated from the Twitter App
   * **Client Secret:** enter in your API Secret generated from the Twitter App
   * **Token Parameter Type**: choose 'Header'
   * **Token Parameter name**: enter 'Authorization'
   * **Token Parameter Value Template**: enter 'Bearer {token}'

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-92c8747e94edc9e760e58a904a03bcb0332d2c69%2Fsetting-up-integrations-v182-2.png?alt=media) ![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-946bda9e6a95d9f435a9424ded0c7e779f6277ef%2Fsetting-up-integrations-v182-3.png?alt=media)

4. Click **Create** to finish creating the custom integration

### Connecting the custom integration to Airkit

After setting up the custom integration, you need to connect the integration to Airkit. This will surface the integration to your application and make it usable in the app.&#x20;

1.  In the Airkit Console, go to **Integrations** and then \*\*Connected Accounts.

    ![](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-e3f22ead7fda491349c538f2375ef2cc6492b3e8%2Fsetting-up-integrations-v182-4.png?alt=media)\*\*
2. Click on **Create new** and give the credential a name and choose the Twitter integration in the dropdown menu. Then click on **Create**, which then enables you to connect Twitter to your Airkit App!

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-d10394c6d8fdd018c55839f6025055ad0424e9d3%2Fsetting-up-integrations-v182-5.png?alt=media)

## Using an API Token to integrate with GIPHY

This example demonstrates how to create a custom integration with the [GIPHY API](https://developers.giphy.com/docs/sdk) that uses an API Token and connect it to an application.

### Prerequisites

* [GIPHY Developer Account](https://developers.giphy.com/)
* GIPHY App with associated API Key

### Setting up your custom integration

1.  Sign in to [console.airkit.com](https://console.airkit.com) and select **Integrations** and then \*\*Custom Integrations.\*\*This is where to manage the integrations associated within organization.

    ![cusromintsmall.png](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-515a65520cf95a1fb9bbb1f12af650bd1eb4c597%2Fsetting-up-integrations-v182-0.png?alt=media)
2. Then click on **Create new** to add the new Custom Integration. Enter the name of the service and a unique key. This key is a global unique identifier associated with your custom integration. Then select API Token for the Authentication Type. This will then expand the fields that are required to create the integration.

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-1e6c5c2f09041f1f8cfa09c5b586a1377531f299%2Fsetting-up-integrations-v182-7.png?alt=media)

3. For the GIPHY API, provide the following for the configuration fields:
   * **Token Paramater Type**: choose 'URL Parameter'
   * **Token Parameter Name:** enter 'api\_key'
   * **Token Parameter Value Template:** enter '{token}'

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-24efb57ab13b9ecb9577b8c5780f457be6c18eb8%2Fsetting-up-integrations-v182-8.png?alt=media)

4. Click on **Create** to finish creating the custom integration

### Connecting your custom integration to Airkit

After setting up the custom integration, you need to connect the integration to Airkit. This will surface the integration to your application and make it usable in the app.&#x20;

1.  In the Airkit Console, go to **Integrations** and then \*\*Credentials.

    ![](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-e3f22ead7fda491349c538f2375ef2cc6492b3e8%2Fsetting-up-integrations-v182-4.png?alt=media)\*\*
2. Click on **Create new** and give the credential a name and choose the GIPHY integration in the dropdown menu.&#x20;

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-b401bb7f7aca944c232867cd4dee3a994937d4ae%2Fsetting-up-integrations-v182-10.png?alt=media)

3. Then provide your API Token from your GIPHY app and click on **Create** to create an integration from GIPHY to Airkit.

![organizing info](https://3088276961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC6qMwMGWBgxnN70QsDuH%2Fuploads%2Fgit-blob-7e50802c466488caf6db0ecc548ff11ea9d1d561%2Fsetting-up-integrations-v182-11.png?alt=media)

## Using Integrations in an App

Now that the integrations is added, they can now be used in an application. Integrations can be used to call API endpoints directly from [Connections Builder](../../studio/builder-bar/connections-builder) using the HTTP Operation.
