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

> SMS channel permissions: send, read history, and cancel scheduled messages.

<Tip>
  The **API Key** is your access card: each **scope** opens one door. In production, grant only what your integration needs.
</Tip>

## In brief

* `sms:*` scopes cover send, read, and cancel.
* SMS **does not use instances**, there is no `instanceIds` on this channel.
* General guide: [API Keys](/en/guides/api-key/index). First send: [Quick Start](/en/sms-api/como-funciona/quick-start).

***

## How to send the key

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

Alternative: `x-api-key: sk_live_xxxxx`.

<Warning>
  An **empty** scope list on create = **ADMIN** access (everything). Always restrict in production.
</Warning>

***

## Ready-made combinations

<CardGroup cols={2}>
  <Card title="Send only" icon="paper-plane">
    `sms:send`
  </Card>

  <Card title="Send and query" icon="magnifying-glass">
    `sms:send`, `sms:read`
  </Card>

  <Card title="With scheduling" icon="clock">
    `sms:send`, `sms:cancel`
  </Card>

  <Card title="Full flow" icon="list-check">
    `sms:send`, `sms:read`, `sms:cancel`
  </Card>
</CardGroup>

***

## Available scopes

<AccordionGroup>
  <Accordion title="sms:send">
    Send immediate or scheduled SMS (`POST /v1/sms/messages`).
  </Accordion>

  <Accordion title="sms:read">
    List sent messages, query by id, and inbound MO.
  </Accordion>

  <Accordion title="sms:cancel">
    Cancel scheduled (`SCHEDULED`), credits refunded.
  </Accordion>
</AccordionGroup>

***

## Common errors

| HTTP / `code`                   | What to do                           |
| ------------------------------- | ------------------------------------ |
| **401** `UNAUTHORIZED`          | Check `Authorization: Bearer sk_...` |
| **403** missing scope           | Add the route scope to the key       |
| **403** `PLAN_LIMIT_CREDITS`    | Not enough credits to send           |
| **403** `PLAN_LIMIT_SCHEDULING` | Scheduling not on your plan          |

Full catalog: [Error responses](/en/guides/conceitos/resposta-de-erros) (**SMS** accordion).

***

## Next steps

* [Quick Start](/en/sms-api/como-funciona/quick-start)
* [Webhook events](/en/sms-api/como-funciona/eventos-do-webhooks)
* [Introduction](/en/sms-api/como-funciona/introducao)