Sync People Job

Start an async CRM sync job for people (and their parent accounts).

Creates a background job that syncs the specified people to the connected CRM (Salesforce or HubSpot). Parent accounts are automatically resolved and synced first. Returns a job_id immediately for status polling.

Flow:

1. Call this endpoint -> get job_id
2. Poll /check-job-status with job_id until status is “completed” or “failed”
3. When completed, the result field contains detailed sync results for both accounts and people

Behavior:

• Parent accounts are synced first
• Accounts already in CRM with the same owner are updated with latest signals
• Accounts in CRM with a different owner are updated with new signals. Ownership stays unchanged.
• New accounts are created in CRM
• People already in CRM with the account having same owner are updated with latest signals
• People already in CRM with the account having different owner are updated with new signals. Ownership stays unchanged.
• New people in account having same owner are created with assigned user as the people owner.
• New people in account having different owner are created with account owner as the people owner.

POST /api/v1/crm/sync-people-job

Sync People Job

cURL

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/crm/sync-people-job \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "people_ids": [
    123
  ],
  "assigned_user_email": "<string>"
}
'

200

{
  "job_id": "<string>",
  "status": "<string>",
  "message": "<string>",
  "connected_crm": "<string>",
  "total_records": 123
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

people_ids · integer[] · required

People IDs to sync to CRM (accounts resolved automatically)

Required array length: 1 - 500 elements

assigned_user_email · string | null

Email of user to assign CRM records to. If omitted, assigns to authenticated user.

Response

200

application/json

Successful Response

job_id · string · required

status · string · required

message · string · required

connected_crm · string · required

total_records · integer · required