API Setup

Choose your Host Region to have the documentation adapt to your use case.

Business Use Case

You can use this API to create or update Contacts in CustomerGauge. You can then leverage these in Manual Campaigns, or refer to them when doing a Surveys import.

Our PUT Records API has a wide variety of applications. The API allows you to create or update a single record into any of the following objects:

• Account
• Account Alias
• Contact
• Survey (no update supported)
• Activity
• Multi-Object

Good to Know

Changes to Import Configurations

If a change happens to the implementation of the API (for example a field name change), that should be reflected in the used Import Configuration as well. Ignoring to do so will cause the API to silently fail for the fields involved.

Required Fields

The following fields are required in your Import Configuration:

Preparations

A configuration reference is required to make requests to this API, all your configurations and references can be found in Data → Imports → Configurations or clicking here.

We provide default configurations that you can also use*:

Each configuration data type is used to import a different kind of data into the system and it affects the required fields for a successful import. 

*The default configurations are available for systems created after 24 September 2021.

Setting up a Contacts Import Configuration

1. Go to Data > Imports > Configurations page. (or click here)

2. Select the API Configurations type.

3. Click on “Add configuration” button.

4. On “Data type” choose “Multi-object” and fill the “Configuration name” field.

5. On “File Mapping” choose all the fields you want to import into the system and their file heading.

6. Click on the “Save” button to add the configuration.

Authentication

OAuth2 Authentication is used to connect to this API. Once you've created your Connected App, you can acquire a Bearer Access Token by calling our OAuth2/Token API:

curl -X POST -H "Content-Type: application/x-www-form-urlencoded"
-d "grant_type=client_credentials&client_id={{ Client ID }}&client_secret={{ Client Secret }}"
https://auth.{{ apiRegion }}.customergauge.com/oauth2/token

The acquired Bearer Access Token is used in the Authorization header in your API request.

Endpoint

https://imports.api.{{ apiRegion }}.customergauge.com/records/

Request

Parameters

Use these parameters in the URL to pass the relevant information to the API. Parameter keys and values need to be URL-encoded.

Response

{
    "message": "The given data was invalid.",
    "errors": {
        "configuration": [
            "The configuration field is required."
        ]
    }
}

Examples

Postman example

Download Postman example

After importing the Postman example, make sure to change the Host Region and Authentication accordingly.

cURL example

curl -H "Authorization: Bearer XXXXX" https://imports.api.{{ apiRegion }}.customergauge.com/records?configuration=16b53fd0-9103-431f-a5bd-f492b3eeb835&record[Account%20Name]=Example%20Corp&record[Email]=john.doe@example.com&record[First%20Name]=John&record[Last%20Name]=Doe

Not the API you're looking for?

Get an overview of our APIs here.