Skip to main content

Authorization

Follow this guide to create a new GIPHY API credential that will allow Nexla to authenticate to and retrieve data from the GIPHY API.
giphy_api_auth.png

GIPHY API

Prerequisites​

To connect Nexla to the GIPHY API, you need a GIPHY developer account and an API key. GIPHY uses API key authentication — every request to the API must include your API key as a query parameter. API keys are issued through the GIPHY Developer Dashboard and can be created free of charge.

All new API keys begin as beta keys, which are rate-limited to 100 API calls per hour. If your integration requires higher throughput, you can submit a production key application through the Developer Dashboard. GIPHY will review the application and, if approved, provision a production key with higher rate limits.

Create a GIPHY Developer Account and API Key​

  1. Navigate to the GIPHY Developer Portal at developers.giphy.com and click Create Account to register. If you already have a GIPHY account, click Log In instead.

  2. After signing in, you will be taken to your Developer Dashboard. Click the Create an App button to begin creating a new application.

  3. On the app creation screen, select API as the app type (as opposed to the SDK option), then click Next Step.

  4. Enter a name for your application in the App Name field (for example, Nexla Integration) and a brief description in the App Description field explaining how you intend to use the API.

  5. Check the checkbox to agree to the GIPHY API Terms of Service, then click Create App.

  6. Your new application will appear on the Developer Dashboard. The API Key is displayed directly below the app name. Copy this value and store it securely — you will need it when configuring your Nexla credential.

Important

Keep your API key confidential. Do not commit it to source control or share it in public forums. If your key is compromised, you can regenerate it from the Developer Dashboard.

Beta API keys are rate-limited to 100 requests per hour. To request a production key with higher limits, visit your Developer Dashboard and submit a production key application. For complete details on rate limits and key tiers, refer to the GIPHY API FAQ and the Request a GIPHY API Key support article.

Create a GIPHY API Credential​

  • To create a new GIPHY API credential, after selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Settings​

  1. Enter your GIPHY API key in the API Key field. This key is appended as the api_key query parameter to every request Nexla sends to the GIPHY API and is required for all endpoints.

    The API key is stored securely by Nexla and is masked after saving. To rotate or revoke an API key, return to the GIPHY Developer Dashboard and manage your app's key from there.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source creation and can be selected for use with a new data source.