> ## 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.

# Escopos da API Key

> forms:manage e forms:submit, permissões da API v1 de Forms.

<Tip>
  Só existem dois escopos em Forms. **manage** = operar formulários; **submit** = receber inscrições.
</Tip>

## Como enviar a chave

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

ou `x-api-key`.

<Info>
  A API Key pertence a **um** workspace. Na v1 **não** envie `x-workspace-id`.
</Info>

## Escopos

<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>

## Combinações comuns

| Integração                      | Escopos                        |
| ------------------------------- | ------------------------------ |
| Backend que só envia leads      | `forms:submit`                 |
| Painel/ETL que lista inscrições | `forms:manage`                 |
| CRUD completo + subscribe       | `forms:manage`, `forms:submit` |

## Webhooks

Eventos `form.*` configuram-se em **Integrações → Webhooks**, veja [Eventos de webhooks](/marketing-addons-api/como-funciona/eventos-do-webhooks).

## Próximos passos

* [Quick Start](/marketing-addons-api/como-funciona/quick-start)
* [Introdução](/marketing-addons-api/como-funciona/introducao)