Skip to main content

Creating a service account

A service account lets an application send authenticated requests to the Webmarketer API.

Service accounts are accounts tied to your workspace.

To create a service account:

  1. Go to your workspace's agent management page from the configuration menu.
  1. Click the add button in the "Add a service account" section.
  1. Pick a name and a role for your service account, then submit the form.
Role

The selected role is the role of the service account on the workspace, and therefore on all of its projects.

  1. Once the service account is created, you are redirected to its key management page.

Creating a service account key

To authenticate against the Webmarketer API with a service account, you need a service account key.

  1. From a service account's key management page (reachable from the workspace's agent list), click the "Add a key" button.

  2. A unique key allowing authentication against the API is downloaded to your machine — keep this key safe.

You now have an API key you can use to negotiate an API access token.