API keys and webhook secrets

Why keys are shown only once, how to create, replace and revoke them, and how to rotate a webhook signing secret.

Keys are shown only once

When you create an API key or a webhook signing secret, Chattiv shows it in a pop-up one time. Copy it and store it somewhere safe, like your server's environment settings or a password manager. Chattiv keeps only a scrambled fingerprint of each key, the same way passwords are stored. Nobody, including our team, can look it up later.

Lost a key? You can't recover it, but replacing it takes a minute:

  1. Create a new key (below) for the same agent.
  2. Put the new key in your agent's settings.
  3. Revoke the old key.

Create a key

On AI & API, under API keys:

  • Name: something you'll recognize, like "Production server".
  • Agent: the agent the key acts as. Choose None (read only) for a key that only reads conversations, for example for reporting.
  • Mode: Live, or Test for experiments (test keys start with chv_test_ and tag their messages as test).

Click Create key and copy it from the pop-up.

Revoke a key

Click Revoke next to it. Anything using that key stops working immediately. The list shows when each key was last used, which helps you find old ones.

Webhook signing secrets

Every webhook Chattiv sends includes an X-Chattiv-Signature header. Your agent recomputes it with the signing secret to prove the request came from Chattiv. The Agent API docs show exactly how.

If you lost the secret, or think someone else has it, click New secret on the agent's card. The new secret appears in the pop-up. Update your agent right away, because webhooks are signed with the new secret from then on. The webhook URL doesn't change.

Keep keys safe

  • Never put an API key in website code or a browser. It belongs on your server.
  • Use a separate key for each server or tool so you can revoke one without breaking the others.
  • Only owners and admins can create or revoke keys.

Related guides

Still stuck?

Use the chat in the corner of this page. Ava answers right away from this help center, and she can bring in a person from our team.

Start free