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

# Autenticación

> Cómo autenticar solicitudes a la API de Insurance Boosters con x-ib-api-key.

Las integraciones externas se autentican con una **API key** enviada en el encabezado `x-ib-api-key`.

## Encabezado requerido

```http theme={null}
x-ib-api-key: <tu-api-key>
```

<Warning>
  No compartas tu API key en repositorios públicos, logs o capturas de pantalla.
</Warning>

## Obtener una API key

Las API keys las emite Insurance Boosters para cada integración. Si no tienes la tuya, solicítala con tu **ejecutivo de cuenta**.

## Ejemplo de solicitud

```bash theme={null}
curl -X POST "https://api.insuranceboosters.com/api/v1/whatsapp/{phoneNumberId}/template" \
  -H "Content-Type: application/json" \
  -H "x-ib-api-key: TU_API_KEY" \
  -d '{
    "to": "<numero-e164>",
    "name": "<nombre-plantilla>",
    "language": "es",
    "components": []
  }'
```

Sustituye `{phoneNumberId}`, `<numero-e164>` y `<nombre-plantilla>` por tus valores reales.

## Respuestas de autenticación

Los errores de autenticación devuelven JSON con el campo `message`:

```json theme={null}
{ "message": "Invalid API key." }
```

```json theme={null}
{ "message": "No API key provided." }
```

| Código | Significado                              |
| ------ | ---------------------------------------- |
| `401`  | API key inválida, expirada o no enviada. |

<Note>
  Los errores de validación del body de envío (por ejemplo, falta `to`) usan el campo `error` en lugar de `message`.
</Note>

## Siguiente paso

<Card title="Listar plantillas" icon="list" href="/whatsapp/listar-plantillas">
  Consulta las plantillas aprobadas de tu línea antes de enviar.
</Card>