Send Contact Vcard - Wawp WhatsApp API

POST /sendContactVcard

Sends one or multiple contact cards (vCards) to a chat. This allows the recipient to easily save the contact details to their phone's address book.

Developer Tips & Best Practices:

vCard Formatting: The vcard string must be properly formatted according to the vCard 3.0 standard (start with BEGIN:VCARD and end with END:VCARD).

WhatsApp ID: To ensure the "Message" button appears on the contact card in WhatsApp, include the waid=PHONE_NUMBER parameter in the TEL field (e.g., TEL;type=CELL;waid=15551234567:+1 555-123-4567).

Multiple Contacts: You can send multiple contacts in a single message by adding more objects to the contacts array.

Request

Body Params application/json

Example

{
  "instance_id": "123456789",
  "access_token": "123456789",
  "chatId": "447441429009@c.us",
  "contacts": [
    {
      "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Jane Doe\nORG:Company Name;\nTEL;type=CELL;type=VOICE;waid=911111111111:+20 11111 11111\nEND:VCARD"
    },
    {
      "fullName": "John Doe",
      "organization": "Company Name",
      "phoneNumber": "+201 11111 11111",
      "whatsappId": "2011111111111",
      "vcard": null
    }
  ],
  "reply_to": null
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Success

application/json

Body

Example

{
    "id": "true_1234567890@c.us_AAAAAAAAAAAAAAAAAAAAAA",
    "_data": {
        "Info": {
            "Chat": "1234567890@s.whatsapp.net",
            "Sender": "1234567890:13@s.whatsapp.net",
            "IsFromMe": true,
            "IsGroup": false,
            "AddressingMode": "",
            "SenderAlt": "",
            "RecipientAlt": "",
            "BroadcastListOwner": "",
            "BroadcastRecipients": null,
            "ID": "AAAAAAAAAAAAAAAAAAAAAA",
            "ServerID": 0,
            "Type": "",
            "PushName": "",
            "Timestamp": "2026-01-03T00:36:53Z",
            "Category": "",
            "Multicast": false,
            "MediaType": "",
            "Edit": "",
            "MsgBotInfo": {
                "EditType": "",
                "EditTargetID": "",
                "EditSenderTimestampMS": "0001-01-01T00:00:00Z"
            },
            "MsgMetaInfo": {
                "TargetID": "",
                "TargetSender": "",
                "TargetChat": "",
                "DeprecatedLIDSession": null,
                "ThreadMessageID": "",
                "ThreadMessageSenderJID": ""
            },
            "VerifiedName": null,
            "DeviceSentMeta": null
        },
        "Message": {
            "contactsArrayMessage": {
                "contacts": [
                    {
                        "displayName": "",
                        "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Jane Doe\nORG:Company Name;\nTEL;type=CELL;type=VOICE;waid=REDACTED_PHONE:+1 555 010 1234\nEND:VCARD"
                    },
                    {
                        "displayName": "",
                        "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nORG:Company Name;\nTEL;type=CELL;type=VOICE;waid=REDACTED_PHONE:+1 555 010 5678\nEND:VCARD"
                    }
                ]
            }
        },
        "IsEphemeral": false,
        "IsViewOnce": false,
        "IsViewOnceV2": false,
        "IsViewOnceV2Extension": false,
        "IsDocumentWithCaption": false,
        "IsLottieSticker": false,
        "IsBotInvoke": false,
        "IsEdit": false,
        "SourceWebMsg": null,
        "UnavailableRequestID": "",
        "RetryCount": 0,
        "NewsletterMeta": null,
        "RawMessage": {
            "contactsArrayMessage": {
                "contacts": [
                    {
                        "displayName": "",
                        "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Jane Doe\nORG:Company Name;\nTEL;type=CELL;type=VOICE;waid=REDACTED_PHONE:+1 555 010 1234\nEND:VCARD"
                    },
                    {
                        "displayName": "",
                        "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nORG:Company Name;\nTEL;type=CELL;type=VOICE;waid=REDACTED_PHONE:+1 555 010 5678\nEND:VCARD"
                    }
                ]
            }
        }
    }
}