You can use this API to integrate your systems to Add or Update Accounts inside your CustomerGauge platform.

You can also add additional Account Properties such as Account Manager, Parent Account and Reporting Region that can soon be filtered upon.

Important: This API is deprecated, and should not be used anymore. We are working on a replacement.

Good to know

Authentication through OAuth2 only

We only support OAuth2 authentication on this API.

Reference is also the Account Name:

The provided reference will be mapped to Account Name, and displayed throughout the platform as such.

API response format:

This API returns data in JSON format

About this API

Resource Information

Response formatsJSON
Response familyContracts
HeaderAuthorization: Bearer XXXXX (Access Token)

Resource URL

Europe Production Server:

US Production Server:

Australia Production Server:

How to call

PUT Data

Provide the data, in JSON, in the body of the PUT request.


While the data should provided in a JSON object in the body of the PUT request, we've listed out the possibilities in the table below;

Data Type
reference (this also serves as Account Name)
Required. String, max 128 characters
ACME Industries
String, max 255 characters123
String, max 128 characters
John Doe
String, max 128 characters
ACME Group
String, max 128 characters

Example Request

To call this API through cURL:

curl  -H "Authorization: Bearer XXXXX" -X PUT -d '{"reference":"ACME Industries","number":"123","manager":"John Doe,"parent":"ACME Group","region":"EMEA"}'

Example Result

If successfully created, the HTTP response status will be "201".

If successfully updated, the HTTP response status will be "200".

Message reported on failed operation:

	"message": "The given data was invalid.",
	"errors": {
		"reference": [
			"reference is required."

Not the API you're looking for?