API keys authenticate the Web Widget. They tell the server which workspace is making the request when a chat bubble is embedded on your website. You'll need at least one key before you can configure a Web Widget.

What you'll do

Navigate to Integrations → API Key

Click Generate New Key and name it

Copy the key immediately after generation

Paste the key into the Web Widget configuration

Navigate to API Key

Go to Integrations → API Key. This page shows all your existing keys as cards, with their name, creation date, last-used date, and masked value.

perfect10.id/integration

API Key page showing existing key cards with Name, Created date, Last Used, and masked key value

Generate a New Key

Field	Description
Name *	A recognizable label, e.g. "Website Chat Widget" or "Marketing Site".
Domain Restrictions	Restrict the key to specific domains. Only requests from those domains will be accepted.

Click Generate.

perfect10.id/integration

Generate key modal with Name field and optional Domain Restrictions field

Generate a separate key per environment (staging vs. production). This makes it easy to revoke access for one without affecting others.

Copy the Key Immediately

1. After generation, the full key is shown. Copy it.
2. Store it somewhere safe — in a password manager or your environment's secret store.

perfect10.id/integration

Modal showing the newly generated API key with a prominent Copy button warning

Use the Key in the Web Widget

1. Head to Integrations → Web Widget and paste the key into the API Key field.
2. Select the agent you want the widget to use.
3. To revoke a key, click the Delete (trash) icon on the key card — any widget using it will stop working immediately.

perfect10.id/integration

Set Up the Web Widget