Messages

Send multiple contact cards

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.

POST
/send/contacts

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.

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/contacts" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "contacts": [      {        "display_name": "Maria Silva",        "phone": "5511988887777",        "company": "WUTS",        "email": "maria@example.com"      },      {        "display_name": "Joao Souza",        "phone": "5511977776666",        "first_name": "Joao",        "last_name": "Souza"      }    ]  }'
{  "success": true,  "message_id": "3EB0X7D6E5F4A3B2C1",  "timestamp": "2026-06-15T12:00:00Z",  "message": "Contacts sent successfully",  "contact_count": 2}
{  "error": "Key: 'SendContactsRequest.Contacts' Error:Field validation for 'Contacts' failed on the 'min' tag"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "error": "Failed to send contacts: timeout"}