Setup Guide
Follow these steps to connect BigChange to HighLevel and automatically sync new persons.
Get your BigChange API credentials
Log in to the BigChange Developer Portal and navigate to API Key Management. Create a new API key with the following scopes: contacts:persons:read, contacts:read (for company name lookup), webhooks:read, webhooks:write. Copy your Client ID, Client Secret, and Customer ID.
BigChange Developer PortalGet your HighLevel API credentials
In HighLevel, go to Settings → Integrations → API Keys. Create a Private Integration Token with the contacts.write scope. Also copy your Sub-Account Location ID from Settings → Business Info.
HighLevel DashboardEnter credentials in the Configuration tab
Switch to the Configuration tab and enter all your API credentials. Enable the Opt-out Filter and Company Name Lookup toggles as needed. Click Save Config when done.
Deploy the webhook server
Download the ready-to-deploy Node.js server from the Server Script tab. Copy it to any server running Node.js 18+, set the environment variables, and run: node bigchange-highlevel-sync.mjs. No npm install required.
Register the webhook in BigChange
In the BigChange Developer Portal, open your API key → Manage Webhooks → Create New Webhook. Set the Endpoint URL to your server's public address followed by /webhooks/bigchange, and select the event type person.created.
Webhooks ReferenceEnable sync and test
Toggle the Sync Active switch in the sidebar to enable the integration. Use the Test Sync button in the top bar to fire a test event and confirm persons are appearing in HighLevel.
Your Webhook Endpoint URL
https://sync.hmcompressors.internal/webhooks/bigchangeRegister this URL in BigChange with the person.created event type.