Skip to main content

Contact synchronization

When you activate Coexistence, you can import the contacts saved in the WhatsApp Business app to your Positus account. Contacts become available on the platform along with contacts created through normal conversations.

How to trigger synchronization

Make a POST request to the endpoint below. No request body is required.
Parameters:
  • {NUMBER_ID} — ID of the WhatsApp number already activated with Coexistence.
Synchronization is asynchronous: the call only requests the start of the process. The import can be triggered only once per onboarding, within the 24-hour window after Coexistence activation.

What you receive

Contact synchronization does not generate a webhook event to your endpoint. Positus processes the import internally and reflects the result directly on your account.
Once complete, imported contacts become available:
  • In the contact list of your Positus account;
  • Via the contacts API (see the Contacts section).
Contacts added, edited, or removed in the WhatsApp Business app during Coexistence are reflected in your account as Meta informs them — without requiring additional handling on your side.

Next steps