Data Fetcher Help Center
🚀 Try for free📮 Support
  • 👋Welcome
  • Create Requests
    • Create a request
    • Use table values in requests
    • Use variables in requests
    • Response field mapping
    • Schedule a request
    • Add a request trigger
    • Troubleshoot errors
    • Run request using webhook URL
    • List of Airtable integrations
  • Custom Requests
    • Create a custom request
    • Set request method
    • Set request parameters
    • Request authorization
    • Set request headers
    • Add request body
    • Connect to a preset OAuth API
    • Create a custom OAuth connection
  • Advanced settings
    • Write modes
    • Update based on field(s)
    • Pagination
    • Response data transformations
    • Response JMESPath
    • Add fixed value to output
    • No output mode
    • Rate limit
    • Max response records
    • Run request from button field
    • Denormalize response
    • XML array handling
    • Fixed IP Address
  • Organise Requests
    • Run history
    • Duplicate a request
    • Delete a request
    • Add request description
    • Import request from cURL command
    • Export requests as JSON file
    • Import requests from JSON file
  • Create Sequences
    • Create a sequence
    • Schedule a sequence
    • Run sequence from button field
    • Run sequence using webhook URL
  • Account
    • Upgrade workspace
    • Authorize Data Fetcher and Airtable
    • Add user to workspace
    • Roles and permissions
    • View monthly usage
    • Update name or email address
    • Update payment card
    • Update billing information
    • View invoices
    • Switch workspace
  • Get a Google Maps API key
Powered by GitBook
On this page
  • When do I need to create a custom OAuth connection?
  • Step 1. Set up an app with the API provider
  • Step 2: Create the custom OAuth connection in Data Fetcher
  • Example: Connecting to Zoho People API
  1. Custom Requests

Create a custom OAuth connection

Last updated 9 days ago

When do I need to create a custom OAuth connection?

You'll need to create a custom OAuth connection when:

  • The API you want to connect to only provides access via OAuth (not API keys or other authorization methods).

  • Data Fetcher does not have a for that specific API.

Step 1. Set up an app with the API provider

Most APIs require you to create an app in their developer portal before you can use OAuth. Check the OAuth or Authorization section of the API documentation for specific steps, which typically involve:

  1. Navigating to the developer section of your account

  2. Creating a new app or application

  3. Configuring the app settings

Important: When asked for a redirect URL during app setup, use this Data Fetcher redirect URL:

https://oauth.datafetcher.com/auth/callback

After completing the setup, you'll receive a client ID and client secret. Save these securely - you'll need them in the next step.

Step 2: Create the custom OAuth connection in Data Fetcher

  1. in Data Fetcher.

  2. Click on the Authorization tab.

  3. For Type, select OAuth.

  4. Click the + New button.

  5. At the bottom of the modal that opens, click create custom OAuth connection.

This will open the custom OAuth connection screen, where you'll enter the following details:

Required fields

  • Name: a descriptive name to help you identify this OAuth connection later.

  • Auth type: choose OAuth 1 or OAuth 2 based on what the API documentation specifies (most modern APIs use OAuth 2)

  • Authorization URL: the URL used for the authorization request, when Data Fetcher opens a new tab and asks for permission to access the API (typically looks like https://example.com/oauth/v2/auth).

  • Token URL: the URL used after the authorization request to generate access tokens from the authorization code. This is typically something like https://example.com/oauth/v2/token.

  • Client ID: the app client ID from step 1.

  • Client secret: the app client secret from step 1.

  • Base URL: the root URL that all requests to this API use. e.g. https://example.com/api/ .

  • Scopes (comma separated): a comma separated list of the scopes that you want to access for this API. You can find these in the API documentation.

Optional fields

  • Authorization Parameters: the parameters that will be added to the Authorization URL when making the authorization request. The API documentation will have a list of these parameters. Data Fetcher will automatically include the standard OAuth parameters (response_type,client_id,redirect_uri,response_type,state,client_secret).

  • Token Parameters. The parameters that will be added to the Token URL when making the token request. Data Fetcher will automatically add the grant_type=authorization_code parameter.

  • Request Headers: any extra headers to be supplied with every request when using this custom OAuth connection.

Complete the setup

After entering all details, click Create connection. Data Fetcher will open a new tab to begin the authorization process. If your details are correct, you'll be able to authorize Data Fetcher and start using this custom OAuth connection in your requests.

Example: Connecting to Zoho People API

Here's how to set up a custom OAuth connection for the Zoho People API:

  1. Register with Zoho: Go to the Zoho API Console and register a new client to get your client ID and client secret

  1. Configure in Data Fetcher: Using the Zoho People API OAuth documentation, we enter these values:

Auth type

OAuth 2

Authorization URL

https://accounts.zoho.com/oauth/v2/auth

Authorization Parameters

prompt=consent

access_type=offline

Token URL

https://accounts.zoho.com/oauth/v2/token

Client ID

Client ID from step 1.

Client secret

Client secret from step 1.

Scopes

ZOHOPEOPLE.forms.ALL

Request headers

Authorization=Bearer ${auth.accessToken}

Base URL

https://people.zoho.com/people/api/

preset OAuth connection
Create a custom request