Skip to main content
Permutive uses API keys for authentication. These keys take the form of version 4 UUIDs, which are to be included in the X-API-Key header of requests. 
curl https://api.permutive.app/... \
  -H 'X-API-Key: f9975143-2d88-46dc-9247-1fb6c790e1cc' \
  ...
Alternatively, customers can provide their API key as a query parameter on the k parameter: 
curl https://api.permutive.app/...?k=f9975143-2d88-46dc-9247-1fb6c790e1cc \
  ...

​
Key types

There are two types of API key: public and private.
Key typeDescription
PublicUsed when you cannot guarantee the key won’t be seen by others. These are typically used on your sites & apps.
PrivateUsed when you can guarantee the key won’t be seen by others. These are typically used for making changes to your Permutive account, e.g. creating a new cohort.

​
Creating an API key

You can manage your API keys in the Settings › Keys section of the Permutive Dashboard. To create a new API key, follow these steps:
  1. Navigate to the Keys section of your Permutive organization settings.
  2. Click on the Add Key button.
  3. Choose between a public and private key, and provide a name for your key.
  4. Once you click Add Key, the key you have created will be listed in the Keys section.