API Reference

Create or update a lead

post
https://api.getrotor.com/open-api/leads

Creates a new lead or updates an existing one based on the provided information.

Upsert Logic:

  1. If id is provided, updates the lead with that ID
  2. If no id but phone/email provided, searches for existing lead by phone first, then email
  3. If no existing lead found, creates a new lead

Response Status:

  • 201 Created for new leads
  • 200 OK for updated leads

Tags are merged (not replaced) when updating.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid

Optional — provide to update an existing lead

string
length ≤ 255
string
string
length ≤ 255
string
length ≤ 255
string
length ≤ 255
string
length ≤ 100
string
length ≤ 100
string
length ≤ 20
string
length ≤ 100
tags
array of strings
length ≤ 20
tags
string
length ≤ 2000
string
length ≤ 100
string
length ≤ 100
date-time
number
0 to 10000000
string
length ≤ 100
string
enum
Allowed:
Headers
string
enum
required
Defaults to 1.1.0

Required OpenAPI version header.

Allowed:
Responses

Updated 28 days ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 28 days ago

Did this page help you?