Messages

Send a single contact card

Sends one contact as a WhatsApp vCard through WUTS. The contact's display name and phone are required; first name, last name, company, and email are optional and embedded into the generated vCard.

POST
/send/contact

Sends one contact as a WhatsApp vCard through WUTS. The contact's display name and phone are required; first name, last name, company, and email are optional and embedded into the generated vCard.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/send/contact" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "contact": {      "display_name": "Maria Silva",      "phone": "5511988887777",      "first_name": "Maria",      "last_name": "Silva",      "company": "WUTS",      "email": "maria@example.com"    }  }'
{  "success": true,  "message_id": "3EB0X4C3B2A1F0E9D8",  "timestamp": "2026-06-15T12:00:00Z",  "message": "Contact sent successfully"}
{  "error": "Invalid recipient JID: invalid number"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "error": "Failed to send contact: timeout"}

Send a product catalog list POST

Sends a multi-section product list message to a WhatsApp recipient through WUTS. Each section groups product ids; an optional header product id and JPEG thumbnail (base64 or remote URL) can be attached. Up to 10 sections, 30 products per section, and 100 products per catalog are allowed.

Send multiple contact cards POST

Sends a batch of contacts as a single WhatsApp contacts-array message through WUTS. The contacts array must contain at least one entry; each contact is converted into its own vCard.