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

# API key scopes

> forms:manage and forms:submit, Forms v1 API permissions.

<Tip>
  Only two Forms scopes. **manage** = operate forms; **submit** = receive submissions.
</Tip>

## How to send the key

```http theme={null}
Authorization: Bearer sk_live_your_key_here
```

or `x-api-key`.

<Info>
  The API Key belongs to **one** workspace. In v1 **do not send** `x-workspace-id`.
</Info>

## Scopes

<AccordionGroup>
  <Accordion title="forms:manage">
    * `GET` / `POST` `/v1/forms/lists`
    * `GET` / `PATCH` / `DELETE` `/v1/forms/lists/{id}`
    * `GET` `/v1/forms/lists/{id}/subscriptions`
  </Accordion>

  <Accordion title="forms:submit">
    * `POST` `/v1/forms/subscriptions`
    * `POST` `/v1/forms/subscriptions/confirm`
    * `POST` `/v1/forms/subscriptions/{id}/cancel`
  </Accordion>
</AccordionGroup>

## Common combinations

| Integration                         | Scopes                         |
| ----------------------------------- | ------------------------------ |
| Backend that only sends leads       | `forms:submit`                 |
| Dashboard/ETL listing subscriptions | `forms:manage`                 |
| Full CRUD + subscribe               | `forms:manage`, `forms:submit` |

## Webhooks

Configure `form.*` events under **Integrations → Webhooks**, see [Webhook events](/en/marketing-addons-api/como-funciona/eventos-do-webhooks).

## Next steps

* [Quick Start](/en/marketing-addons-api/como-funciona/quick-start)
* [Introduction](/en/marketing-addons-api/como-funciona/introducao)