> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yo-lead.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API keys

> Create and manage Public API credentials.

API keys are created in the YoLead UI.

Each key has:

* a public key used in `X-YoLead-Key`;
* an API secret used to sign requests;
* a scope: `read` or `read-write`.

<Warning>
  Keep the API secret on your backend only. Do not expose it in browser code, mobile apps, logs, or analytics events.
</Warning>

Scopes:

| Scope        | Access                                                              |
| ------------ | ------------------------------------------------------------------- |
| `read`       | Read endpoints and read-only iframe capabilities.                   |
| `read-write` | Read endpoints plus write operations and write iframe capabilities. |