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

# Enviar SMS

> POST /marketplace/messaging/send-sms — SMS transaccional con plantilla o texto inline — mediante la API de mensajería de gu1 para comunicaciones con clientes.

Envía un SMS transaccional. Requiere integración **SMS** activa. Ver [Resumen de mensajería](/es/api-reference/messaging/overview).

## Endpoint

```http theme={null}
POST https://api.gu1.ai/marketplace/messaging/send-sms
```

## Cabeceras

```http theme={null}
Authorization: Bearer TU_API_KEY
Content-Type: application/json
X-Organization-ID: <uuid>   # opcional
```

## Cuerpo

<ParamField body="to" type="string" required>
  Teléfono (recomendado E.164, ej. `+5491112345678`).
</ParamField>

<ParamField body="senderIndex" type="integer">
  Índice opcional del remitente Twilio en la config de la org.
</ParamField>

<ParamField body="templateParams" type="object">
  Valores para `{{placeholders}}`.
</ParamField>

**Plantilla:** `templateId` (UUID, canal sms). No enviar `body`.

**Inline:** `body` (texto, \~4000 caracteres). No enviar `templateId`. Podés usar `templateParams` con `{{variables}}` en `body`.

## Ejemplo

```json theme={null}
{
  "to": "+5491112345678",
  "body": "Tu código es {{token}}",
  "templateParams": { "token": "482910" }
}
```

Los errores de la API están en **inglés** en `error` cuando `success` es `false`.