Overview
Hightouch exposes a REST API that lets users interact with resources like syncs, models, sources and destinations. Though the REST API is open to all Hightouch users, we aim to build features so you don't need to rely on it directly. For example, Git Sync lets you manage orchestration programmatically.
If you're looking to create a custom destination, it's best to use the HTTP Request destination as your base. If you find you still need to use the REST API directly, about your use case.
To start using the API, you must first create and retrieve an API key from your workspace.
Required permissions
To use Hightouch programmatically through the API, you must use an API key created by an Admin user of your Hightouch workspace. See Role Based Access for more information.
Create an API key
Log in to Hightouch as an Admin user of your Hightouch workspace, then follow these steps:
- From the API keys tab on the Settings page, select Add API key.
- Enter a descriptive Name for your key.
- Copy your API key and store it in a safe location. The key will only be displayed once.
- Click Create API key.
Once you have an API key, you can follow the API Reference documentation to start using the API.
Revoke an API key
Your API key provides read/write access to sensitive Hightouch resources and should be kept secure. If you believe your API key may have been compromised, revoke it immediately.
Log in to Hightouch as an Admin user of your Hightouch workspace, then follow these steps:
- From the API keys tab on the Settings page, select the API key or keys you want to revoke.
- Select Delete selected.
- In the modal that appears, select Delete.
Tips and troubleshooting
If you encounter issues using the Hightouch API, check our status page or contact us for assistance.
Common Errors
The following error indicates an issue with your API key. Check that the creator of the API key is an Admin user of your Hightouch workspace.
{
"message": "Authentication error",
"details": "No user found"
}