Keep Contacts in Sync with an External CRM

This guide shows how to keep contacts in sync between Genju and an external system. You'll use the Contacts API for the initial import, and webhooks to keep things updated in real time.

Loop through your external contacts and call `POST /contacts` for each one. Genju deduplicates automatically by email and phone — so it's safe to call this repeatedly.

for (const contact of externalContacts) {
  await genju.contacts.create({
    full_name: contact.name,
    email: contact.email,
    phone: contact.phone,
    source: 'crm-import',
    tags: ['imported']
  });
}

Register webhooks for `contact.created` and `contact.updated` to push changes from Genju to your external system in real time.

await genju.webhooks.create({
  url: 'https://your-server.com/genju-sync',
  event: 'contact.updated'
});