Legacy API Notice: This documentation covers the Legacy Sent API (v2). While this API remains fully supported, we recommend new integrations use the latest Sent API v3 for enhanced features, improved performance, and long-term support.

Send message to contact

Sends a message to a specific contact using a template. The message can be sent via SMS or WhatsApp depending on the contact's capabilities. Optionally specify a webhook URL to receive delivery status updates. The customer ID is extracted from the authentication token.

POST
/v2/messages/contact

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/problem+json

curl -X POST "https://api.sent.dm/v2/messages/contact" \  -H "Content-Type: application/json" \  -d '{    "contactId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",    "templateId": "7ba7b820-9dad-11d1-80b4-00c04fd430c8",    "templateVariables": {      "name": "John Doe",      "order_id": "12345"    }  }'
Empty
{
  "statusCode": 400,
  "message": "One or more errors occurred!",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
Empty
Empty

Glossary

Definitions of key terms and concepts used throughout the Sent platform and documentation

Send message to phone number POST

Sends a message to a phone number using a template. The phone number doesn't need to be a pre-existing contact. The message can be sent via SMS or WhatsApp. Optionally specify a webhook URL to receive delivery status updates. The customer ID is extracted from the authentication token.