Actions64
- Activity Actions
- Activity Type Actions
- Campaign Actions
- Deal Actions
- Lead Actions
- Lookup Actions
- Membership Actions
- Note Actions
- Organization Actions
- Origin Actions
- Person Actions
- Pipeline Actions
- Tag Actions
Lead → Create
AI-generatedSummary
Create a lead in Arco CRM by sending its required name and any configured optional details in a POST request. Optional campaign enrollment is atomic: if enrollment fails, the lead is not created.
Inputs
- Name (required) — The lead’s name.
- Additional Fields — Optional email, phone, company, origin, owner membership, traffic attribution details (UTMs, click IDs, landing page, and referrer), state and city, custom data or mapped custom fields, and campaign. Choose a state before selecting a city. Use either Custom Data (JSON) or Custom Fields, not both. The campaign enrolls the new lead in its first stage and requires the campaigns:operate:all scope.
- Idempotency Key — An optional key sent in the Idempotency-Key header. Repeating the same key with the same request body within 24 hours returns the original response; using it with a different body returns a 409 error.
Output shape
A single API response item for the created lead.
The operation sends a POST request to /v1/leads. Custom Data (JSON) is parsed into a JSON value before sending. The API response fields are not specified here.