Skip to content

Creating an API key

API keys let you authenticate with the EmailShepherd API.

Users with the admin or developer role can create API keys. If your organization uses custom roles, anyone with the manage_api_keys permission can create them.

Go to Organization Settings > API Keys, then click Create API key.

The API keys page under Organization Settings, with the Create API key button

Give your key a name that describes what it’s for, so you can recognise it later.

Each key has a set of scopes: the actions the key is allowed to perform. The available actions are grouped by resource (Emails, Projects, Image library, and so on), and most offer Read, Write, and Delete.

An API key can do exactly what its scopes allow, and nothing more.

Selecting scopes when creating an API key

Once you’ve named the key and chosen its scopes, click Create.

Your new key is shown once. Copy it and store it somewhere safe, because you won’t be able to see it again.

The newly created API key shown once

See Authentication for how to use your key to make requests, and the API reference for the full list of available endpoints.