Making your First API Request

Refer to the information in this section to successfully use the Hevo API to create and test API requests and view the API responses.


  • An active Hevo account. Click here to sign up for a free Trial account.
  • A user with an owner role in Hevo for one-time generation of the API credentials.

Step 1: Generating your API credentials

The API credentials are the API Key and Secret that you generate in Hevo and use to authenticate the API request. These credentials must be sent as Basic token in the Authorization header of the request.

Here, the API Key acts as the username and the Secret Key acts as the password. The Basic token is generated by taking the Base64 encoded value of <username>:<password>, or in Hevo’s context, the Base64 encoded value of <api_key>:<api_secret>.

Note: Your credentials are valid for all the APIs and need to be generated only once.


To generate the credentials:

  1. Click on one of the following links to access the API Keys page of the Hevo UI for the region(s) where your account is present:


    Generate API token

  3. Click DOWNLOAD to save the details as a JSON file.

    Download API token


Hevo does not store the API secret key due to security reasons. Therefore, you must save these details in a secure location.

Once you have the API Key and Secret, you can use them as the username and password correspondingly in the Authorization header for all the API calls that you make.

Step 2: Retrieving the base URL

The base URL for the API request is derived from the region of your Hevo account.

Read Base URLs to know how to determine this value.

Step 3: Making the API request

  1. Use the left navigation bar to browse through the API resources and the endpoints available for each of these.

  2. Click an endpoint name to open its detailed view.

    Click an endpoint
  3. Provide the Query Params for the request.

  4. In the top-right section, select the tab for the language format in which you will be using this endpoint. For example, cURL. Click the !more (More) icon to view more languages.

  5. If not already authenticated, provide your Username and Password in the Authentication section.
    These are the API token and Secret Key that you generated in Step 1 above and must be included in the Authorization header of the request.

    Auth details in header
  6. (Optional) Select a different base URL. The default base URL is auto-selected as per your Hevo region.

  7. Click Try It.
    Based on the values you provide, the appropriate Response Code is generated.

  8. (Optional) Click the expand (Expand) icon to view the detailed response received from the API.

Step 4: Validating the API response

As a good practice, you can verify the API response against the data in your Hevo app UI before integrating the endpoint in your application or program.

For example, for the Get Pipelines Schedule endpoint, you can verify if the Pipeline schedule returned by the API (in seconds) matches what you have set up in the Hevo app. Or, if you use the Delete Pipeline endpoint, verify in the Hevo app that the Pipeline is successfully deleted.

NOTE: New Pipelines use the Full Load query mode by default for ingesting the Events. Therefore, if you want to specify a different mode, you must update the mode in the API request at the earliest.

Read more about Query Modes.