Send Contact

POST

https://api.sudonum.com.com/v2/whatsapp/messages/

This allows you to send a Contact Message from your WhatsApp number.

Note: Exclusive only to Meta Whatsapp Accounts and follows all the validation rules set by META (see link below)

See: https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages#contacts-object

Request

Header Params

Body Params application/json

Example

{
    "whatsapp_number": "{{whatsapp_number}}",
    "type": "CONTACTS",
    "to_whatsapp_number": "{{destination_number}}",
    "contacts": [
        {
            "name": {
                "formatted_name": "John Doe",
                "first_name": "John",
                "last_name": "Doe"
            },
            "addresses": [
                {
                    "street": "<ADDRESS_STREET>",
                    "city": "<ADDRESS_CITY>",
                    "state": "<ADDRESS_STATE>",
                    "zip": "<ADDRESS_ZIP>",
                    "country": "<ADDRESS_COUNTRY>",
                    "country_code": "<ADDRESS_COUNTRY_CODE>",
                    "type": "HOME|WORK"
                }
            ],
            "birthday": "YYYY-MM-DD",
            "org": {
                "company": "Business Name"
            },
            "phones": [
                {
                    "phone": "27...",
                    "type": "HOME|WORK"
                }
            ],
            "urls": [
                {
                    "url": "https://business.web.site",
                    "type": "HOME|WORK"
                }
            ]

        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.sudonum.com.com/v2/whatsapp/messages/' \
--header 'Content-Type: application/json' \
--data '{
    "whatsapp_number": "{{whatsapp_number}}",
    "type": "CONTACTS",
    "to_whatsapp_number": "{{destination_number}}",
    "contacts": [
        {
            "name": {
                "formatted_name": "John Doe",
                "first_name": "John",
                "last_name": "Doe"
            },
            "addresses": [
                {
                    "street": "<ADDRESS_STREET>",
                    "city": "<ADDRESS_CITY>",
                    "state": "<ADDRESS_STATE>",
                    "zip": "<ADDRESS_ZIP>",
                    "country": "<ADDRESS_COUNTRY>",
                    "country_code": "<ADDRESS_COUNTRY_CODE>",
                    "type": "HOME|WORK"
                }
            ],
            "birthday": "YYYY-MM-DD",
            "org": {
                "company": "Business Name"
            },
            "phones": [
                {
                    "phone": "27...",
                    "type": "HOME|WORK"
                }
            ],
            "urls": [
                {
                    "url": "https://business.web.site",
                    "type": "HOME|WORK"
                }
            ]

        }
    ]
}'

Responses

🟢201

application/json

Bodyapplication/json

Example

{
    "uuid": "4bdada52-b39c-4054-bf34-22bae66c31ff",
    "type": "CONTACTS",
    "status": "QUEUED",
    "status_description": "",
    "whatsapp_number": "<WHATSAPP_ACCOUNT>",
    "direction": "OUTBOUND",
    "from_whatsapp_number": "<WHATSAPP_ACCOUNT>",
    "to_whatsapp_number": "<DESTINATION_NUMBER>",
    "message_data": {
        "contacts": [
            {
                "name": {
                    "formatted_name": "John Doe",
                    "first_name": "John",
                    "last_name": "Doe"
                },
                "addresses": [
                    {
                        "street": "<ADDRESS_STREET>",
                        "city": "<ADDRESS_CITY>",
                        "state": "<ADDRESS_STATE>",
                        "zip": "<ADDRESS_ZIP>",
                        "country": "<ADDRESS_COUNTRY>",
                        "country_code": "<ADDRESS_COUNTRY_CODE>",
                        "type": "HOME"
                    }
                ],
                "birthday": "YYYY-MM-DD",
                "org": {
                    "company": "Business Name"
                },
                "phones": [
                    {
                        "phone": "27...",
                        "type": "WORK"
                    }
                ],
                "urls": [
                    {
                        "url": "www.business.home",
                        "type": "WORK"
                    }
                ]
            }
        ]
    },
    "meta_data": {},
    "context_data": {},
    "created": "2024-06-28T13:55:08.043613Z",
    "modified": "2024-06-28T13:55:08.050863Z"
}

Modified at 2026-08-31 07:42:46

All Messages from Campaign Log

Send Text Message