Skip to main content
POST
/
reseller
/
customers
Add a customer or lead manually
curl --request POST \
  --url https://api.offergrid.io/reseller/customers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fullName": "Jane Doe",
  "email": "jane@example.com",
  "phone": "+1-555-123-4567",
  "addressLine1": "123 Main St",
  "addressLine2": "Apt 4B",
  "city": "San Francisco",
  "state": "CA",
  "postalCode": "94102",
  "country": "US",
  "kind": "lead",
  "source": "manual",
  "notes": "<string>",
  "tags": [
    "<string>"
  ],
  "customFields": {
    "sourceUrl": "https://example.com/listing/42"
  }
}
'

Authorizations

​
x-api-key
string
header
required

Team API key for authentication. Your team role (provider/reseller/hybrid) determines which endpoints you can access.

Body

application/json
​
fullName
string
required
Example:

"Jane Doe"

​
email
string
Example:

"jane@example.com"

​
phone
string
Example:

"+1-555-123-4567"

​
addressLine1
string
Example:

"123 Main St"

​
addressLine2
string
Example:

"Apt 4B"

​
city
string
Example:

"San Francisco"

​
state
string
Example:

"CA"

​
postalCode
string
Example:

"94102"

​
country
string
Example:

"US"

​
kind
enum<string>
default:lead

Whether to track as a lead (pre-order) or as a customer.

Available options:
lead,
customer
​
source
enum<string>
default:manual

Where this contact came from.

Available options:
order,
link,
api_import,
manual,
event
​
notes
string
​
tags
string[]
​
customFields
object

Open-ended attributes (source URL, external IDs, etc.)

Example:
{
  "sourceUrl": "https://example.com/listing/42"
}

Response

Customer created