Server-to-server (S2S) API

Use the Adjust server-to-server API to connect your app to Adjust without changing your app code.

Authentication

The S2S API uses Bearer tokens for authentication. You MUST include your Adjust API token in an Authorization header with each request you make to the Blocklist API.

If your organization has enabled Single Sign-On (SSO), contact your Adjust representative or email support@adjust.com for help with finding your API token.

For non-SSO accounts, API tokens are located in a user’s profile. To find your token, follow these steps:

1. Select the account (user) icon.
2. Select Account settings.
3. Select the My profile tab.
4. Your API Token is shown with your User Details. Select the copy button to copy the token to your system clipboard.

Reset your Adjust API token

You can reset your Adjust API token at any time. Resetting your token invalidates the old token. If you reset your Adjust API token, you MUST replace your old token anywhere that you’re using it. Requests made with an invalidated token are rejected by Adjust.

To reset your Adjust API token:

1. Select the account (user) icon.
2. Select Account settings.
3. Select the My Profile tab.
4. Your API Token is shown with your User details.
5. Select Reset API token.
6. Enter your account password in the modal that appears and select Reset to reset your API token. A confirmation appears in the top right of the screen.
7. Select the copy button next to the API Token to copy the token to your system clipboard.

S2S endpoints

Device identifiers

The device identifiers accepted for S2S events are as follows:

Preferred identifiers

Backup identifiers

Event submission responses

All successfully recorded events return an OK response.

Failed events return an HTTP error code and JSON message.

{ "error": "Event request failed (${error_message})" }

Error messages define the request problem. Use this table to identify your error, then review your setup or reach out to support@adjust.com for help.