Import Contacts via Webhook

The contact manager allows you to import contacts from an external data source via webhooks. To import contacts, you need the Webhook URL and API Secret.

Following are the steps to import contacts from an external source –

Step 1: Go to the Contact Manager page and get the Webhook URL.

Step 2: Click on the Generate Secret button. It will take you to your account settings page.

Step 3: Click on the Generate button to generate your API Secret. It will appear in the API Secret field on the left side of the button.

Step 4: After this, you can use the Webhook URL to receive data from an external source. Make note of the following points –

  • The method used for invoking webhook should be POST.
  • Include this header in your request – “Authorization: Bearer YOUR_API_SECRET
  • Make sure the request body is in the following format –
{ 
 "contact": { 
 "name": "CONTACT_NAME", 
 "email": "EMAIL", 
 "phone": "PHONE_WITH_COUNTRY_CODE", 
 "tags": ["Tag1", "Tag2"], 
 "override_tags": "true", 
 "meta": { 
 "Country": "USA", 
 } 
 } 
 }
  • The “override_tags” field is optional. If you receive a contact multiple times with a change in status/some_other_info and want to append any new info to tags, then set this value to “false”. Setting it to “true” will override all previously existing tags for the same contact. This parameter can be ommitted. It’s default value is false.
  • Any extra fields can be included inside the “meta” field.