Skip to main content
A machine user can have several API keys, so you can rotate them without downtime. Each API key carries its own fine-grained permissions.
1

Create a machine user

Go to Settings → Machine Users and click + Add Machine UserA machine user has two fields:
  • Name: visible only to you and could indicate the usage e.g. “Autoresponder”
  • Public name: This is the name visible to customers (if the machine user interacts with customers) e.g. “Mr Robot”
2

Create an API Key

Click “Add API key” and select the permissions you need. When making API calls, if you have insufficient permissions, the error should tell you which permissions you need.The relevant documentation will tell you which permissions are required for each feature.Once you’ve made an API key you should copy it and put it somewhere safe, as you will not be able to see it again once you navigate away.
3

Go build things 🚀

Now that you have an API key, pass it on any API call as a header: