SKV Connect Partner API

WhatsApp

Session messages require an open 24h window. Templates can start a new thread.

Send session text

POST /api/v1/partner/whatsapp/messages
{
  "to": "919876543210",
  "type": "text",
  "text": "Your order is confirmed."
}

Send template

POST /api/v1/partner/whatsapp/templates
{
  "to": "919876543210",
  "templateName": "hello_world",
  "language": "en",
  "components": []
}

List templates

GET /api/v1/partner/whatsapp/templates

Message status

GET /api/v1/partner/whatsapp/messages/{id}

Use the id from the send response. Status updates as Meta webhooks arrive (sent โ†’ delivered โ†’ read).

Idempotency

Pass Idempotency-Key on POSTs. The same key + key + path replays the stored response for 24 hours.

Coming later

/api/v1/partner/sms/* and /api/v1/partner/voice/* are reserved in OpenAPI and not implemented.