Skip to main content
POST
Available only on WhatsApp

Path parameters

string
required
Unique identifier of the bot sending the message.

Body parameters

string
required
Message type. Must be "contacts".
string
required
Message recipient. Accepts a phone number in E.164 format without the leading + (e.g. 593999999999) or a BSUID (e.g. US.13491208655302741918) for users who have enabled phone number privacy in WhatsApp. See Identifying the recipient.
object[]
required
List of contact cards.

Response

boolean
true if the message was sent successfully.
string
Identifier of the sent message.

Important Notes

Phone Format: Always use E.164 format for phone numbers (e.g.: +PHONE_NUMBER) to ensure compatibility across different regions.
Contact Completeness: Although all fields are optional, providing complete contact information (name, phone, email) improves the user experience and makes contacts more useful.

Use Cases

  • Sharing support contact information
  • Referring users to specific team members
  • Providing business card information
  • Sharing emergency contacts