Skip to main content
n8n CRM sync lets an automation workflow push external CRM data into Soundcheck. It is designed for organization-specific imports from tools such as HubSpot, Flex, or custom booking systems.

​
Endpoint

Send sync requests to: 
POST /webhooks/n8n/crm-sync
The webhook can ingest customers, contacts, venues, events, and external ID mappings in one signed payload.

​
Required configuration

Configure these environment variables before enabling the workflow:
VariablePurpose
N8N_CRM_SYNC_SECRETShared secret used to sign webhook requests
N8N_CRM_SYNC_ORGANIZATION_IDThe Soundcheck organization allowed to receive this feed
The payload must include soundcheck_organization_id, and it must match the configured organization ID.

​
Request signing

Every request must include an HMAC-SHA256 signature: 
X-Soundcheck-N8N-Signature: sha256=<hex-digest>
Generate the digest from the raw request body using N8N_CRM_SYNC_SECRET.
Unsigned requests, incorrectly signed requests, or requests for the wrong organization are rejected.

​
Payload contents

The sync payload can include:
  • Customer identity and contact details
  • Additional contacts
  • Venue records
  • Event records
  • External IDs for deduping and future updates
Use stable external IDs from the source CRM whenever possible. They make future syncs idempotent and prevent duplicate records.
1

Trigger from source CRM

Start when a customer, booking, contact, or event changes in the external system.
2

Normalize data

Map the source fields into Soundcheck’s sync payload shape.
3

Sign the request

Compute the HMAC signature from the raw JSON body.
4

POST to Soundcheck

Send the payload to /webhooks/n8n/crm-sync with the signature header.

Customers

Synced customer records appear in the customer directory.

Venues

Synced venues can be saved and reused on gigs.

Leads

Use public lead intake for inquiries that should start as pipeline records.