Articles on: Contacts

Add Contacts using Webhook

If you want to add contacts from a 3rd party website, app or using automation tools like Zapier or Pabbly, you can use our webhook feature to do that.

Note 1: This feature in only available in our Startup and higher paid subscription plans. See our Pricing page to learn more.

Note 2: This is an advanced feature so you might need help of your developer to set this up for you if you’re not familiar with webhooks.

Follow the steps below to add contacts using the webhook feature:

Open the Contacts > Import Contacts page and scroll down to the Add contacts using webhook section.
There you’ll see two fields:
Webhook URL – this is your unique webhook URL where you need to send POST request from your website, app or automation tool with your contact data.
Webhook Request Example Data – this is the exact JSON format in which you need to send the POST request with your contact data. Make sure to keep Content-Type as application/json in your request.
Once you send the request the contact will be automatically added to your contacts. If the contact already exists, it’ll be updated with the new data that you send.

That’s all. It’s as simple as we could have made it. 🙂

Webhook Request Data Format:

    "whatsapp_number": "+919876543210",
    "first_name": "John",
    "last_name": "Doe",
    "attributes": {
        "custom_attribute_1": "Value 1",
        "custom_attribute_2": "Value 2",
        "custom_attribute_3": "Value 3"
    "lists": [
    "tags": [
        "new lead",
        "notification sent"
    "status": "subscribed",
    "replace": false

whatsapp_numberWhatsApp phone number of the contact with country extension. string / required
first_nameFirst name of the contact. string / optional
last_nameLast name of the contact. string / optional
attributesContact attributes.
* custom_attribute_1, custom_attribute_2 and so onKey value pair of your custom attributes. array of key-value pairs / optional
statusCan be either subscribed or unsubscribed. strings / optional
listsList names. array of strings / optional
tagsTags. array of strings / optional
replaceKeep this value true to replace existing custom attributes, lists and tags with data sent in the request. Else, keep false. boolean / optional

Updated on: 12/07/2023

Was this article helpful?

Share your feedback


Thank you!