Your first integration in five minutes.

Generate a key, validate the account and make the first query without installing an SDK.

Before you start

An Achadu account on the Professional plan or higher.

Administrator access to the developers area.

An HTTP client like curl, Bruno, Postman or your preferred runtime.

Give it a name that identifies the application, defines the validity, and selects only the necessary scopes. The complete secret appears only once.

The recommended first call is GET /me. It confirms which operation and which actor are linked to the key.

bash

curl https://achadu.com/api/v1/me \
  -H "Authorization: Bearer ach_live_..." \
  -H "Accept: application/json"

Keep the key in a vault of secrets, never in the source code.

Record the x-request-id of responses in error.

Implement backoff for 429 responses and transient failures.

Use a separate key for each application or environment.