Sende meldinger

POST /v1/messages/send er det ene endepunktet for alle kanaler.

Påkrevde felt

to, channel (én av sms, rcs, whatsapp, email, voice) og message er påkrevd — eller send en channels-array i stedet for channel/fallback (se nedenfor).

Kanalfallback

Angi en ordnet fallback-liste, eller den nyere channels-arrayen med primærkanalen først:

{
  "to": "+4512345678",
  "channels": ["whatsapp", "sms"],
  "message": "Bestillingen din er sendt."
}

Hvis WhatsApp-leveringen feiler, prøver plattformen automatisk på nytt via SMS — uten et eget API-kall.

Kanalspesifikke felt

• E-post: sett subject, og htmlmessage (eller det eldre aliaset html) for HTML-body-en. message er fallback-en i ren tekst.
• WhatsApp: send et whatsapp-objekt, f.eks. { "template": "order_shipped" }, for malmeldinger utenfor 24-timers sesjonsvinduet.
• Voice: send et voice-objekt (f.eks. { "voice": "female", "language": "da-DK" }) for TTS-parametere.
• Avsender-ID: sender må være en avsender-ID godkjent i Innstillinger → Avsender-ID-er for SMS/RCS — med mindre kontoen din har allow_unverified_sender aktivert for systemintegrasjoner.

Planlegging og webhooks per melding

scheduled_at (ISO-tidsstempel) utsetter utsendelsen. webhook_url mottar leveringsstatusoppdateringer for akkurat denne meldingen — se Webhooks.

Frekvenstak for markedsføring

Send med en category (f.eks. "newsletter") for at utsendelsen skal telle mot den kategoriens frekvenstak, som konfigureres på tvers av kontoen i sendepolicyen — uavhengig av det globale kanalovergripende taket og eventuelle tak per kanal.

Respons

{
  "message_id": "3fa1e2c0-...",
  "status": "queued",
  "channel": "sms",
  "to": "+4512345678",
  "cost": 0.045,
  "currency": "EUR",
  "created_at": "2026-07-08T10:00:00.000Z"
}

En 402 betyr utilstrekkelig saldo eller manglende betalingsmetode; 403 betyr at kontoen er suspendert, venter på aktivering, eller at avsender-ID-en ikke er godkjent; 409 betyr at mottakeren har reservert seg mot den kanalen.