Skip to main content
Use an API key for report exports, dashboards, or applications that manage campaigns and tracking assets. Public API key creation and use require an eligible paid subscription. Create a separate key for each application so you can revoke its access independently.

​
Choose the smallest useful scope

The available operations are listed in the API reference. Manage keys while signed in to Metricanic.

​
Create and verify a key

  1. Open API keys in the account area and click Create key.
  2. Set Label to the application’s purpose, such as daily-report-export.
  3. Choose Scope. Keep read for the report export example.
  4. Set Expires in to 30, 90, or 180 days.
  5. Click Create key and copy the token immediately. It is displayed only when issued.
  6. Store the token in your application’s server-side secret configuration.
  7. Follow API authentication to verify the workspace and scope.
Send the copied token in API requests. The API keys page shows a key ID for management, which is different from the token.

​
Replace a key during planned maintenance

For an application that must keep running, create a second key with the same needed scope. Deploy the new secret, verify a successful API call, then revoke the old key. Rotate replaces the token immediately and keeps its scope and expiration date. Update the application’s secret with the new token. Use Revoke to stop an application using a key, or if its token has been exposed.

​
Diagnose a stopped integration

Check the key’s expiry, scope, and subscription, then follow API errors. Keep tokens out of browser code. AI agents use a separate MCP connection.