Create or Update Leads
Create or update one lead or a partial-success bulk batch. Safety note: This operation is an upsert: matching source plus external_id, email, or phone can update an existing lead. move deactivates other runs, do_not_contact suppresses enrollment, and forced fields can contact immediately. Bulk identity conflicts are returned per item inside HTTP 201.
assigned_to with the team member’s user ID — get it from GET /team, where each member’s id is the value to use. The owner must be an active member of your account; anything else is rejected with 400.Assigning an owner is independent from workflow_id: workflow_id picks the AI agent that works the lead, assigned_to records which person owns it.Authorizations
Body
- object
- object[]
Arbitrary key-value data specific to your organization. Use this to store any custom information about the lead (e.g., age, salary range, assigned broker, lead status, notes). There is no enforced schema — send any keys and values you need. Values can be strings, numbers, or booleans.
Response
An existing identity was matched and merged.