Add API Domains

API domains tell Approov which backend hosts your app is allowed to fetch Approov tokens for. Add the API host, not the full URL path.

Add Your First API Domain

Use the Approov CLI to add a domain:

approov api -add your.domain

Use the hostname only. For example, use api.example.com, not https://api.example.com/v1/accounts.

Adding a domain has an immediate production impact because apps can begin receiving tokens for that domain, so the CLI asks for confirmation.

Confirm the Domain Was Added

List configured API domains with:

approov api -list

You should see your API domain and token configuration in the output.

Why This Step Matters

Approov tokens are issued for specific API domains. This lets Approov apply the correct token configuration and protect the API channel with managed trust roots or pinning.

The detailed reference is Managing API Domains.

Optional Domain Tasks

After the basic domain is working, use the reference docs for:

• Keyset key API additions.
• No Approov token domains.
• Wildcard mode.
• Demonstration Shapes API setup.

Read Next

Next, add app signing certificates so Approov can recognize official app builds.