Actions28
- Agent Actions
- Favorite Actions
- Group Actions
- History Event Actions
- Hook Actions
- Lead Actions
- Note Actions
- Saved Search Actions
- Source Actions
- Subscription (Webhook) Actions
Lead → Create or Update
AI-generatedSummary
Creates a new Lead or updates an existing one by email via the REW CRM API.
Inputs
- firstName (required) — The first name of the lead.
- lastName (required) — The last name of the lead.
- email (required) — The email address of the lead (used to identify if it should be updated).
- additionalFields — A collection of optional lead details including address, phone numbers, agent ID, groups, heat status, and marketing opt-ins.
Output shape
A list of items containing the created or updated lead record.
If the lead already exists based on the email, it is updated; otherwise, a new record is created. The response returns the full lead object.
Examples
Example 1: Create a new lead from form submission data.
Map form fields to First Name, Last Name, Email, and populate Additional Fields with address, phone, and heat status.
Example 2: Upsert a lead to ensure data consistency.
Use the same email for multiple items; the CRM will create new entries for unique emails and update existing ones.