Create customer

Create a customer. Use this to push contacts from your CRM or sign up flow into Contendar.

POST /customers

If a customer with the same email already exists in the project, the request returns 400. Use Update a customer to change an existing record.

Authentication

Send your API key as a bearer token. See Authentication .

Request body

Field	Type	Required	Notes
`projectId`	UUID	yes	The project to add the customer to.
`name`	string	yes	The customer name.
`email`	string	no	The customer email. Must be unique in the project.
`company`	string	no	The customer company.
`jobTitle`	string	no	The customer job title.
`industry`	string	no	The customer industry.
`avatarUrl`	string	no	A public URL for the customer avatar.
`socialHandle`	string	no	The customer social handle.
`companyLogoUrl`	string	no	A public URL for the company logo.
`source`	string	no	One of `import`, `nps`, `testimonial`, `manual`, `generic`. Defaults to `manual`.

{
  "projectId": "8a7b6c5d-4e3f-2a1b-0c9d-8e7f6a5b4c3d",
  "name": "Dana Lang",
  "email": "dana@acme.com",
  "company": "Acme",
  "jobTitle": "Head of Growth"
}

Response

Returns the created customer. See List customers for the meaning of each field.

Example

curl -X POST "https://app.contendar.com/api/v1/customers" \
  -H "Authorization: Bearer ck_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "YOUR_PROJECT_ID",
    "name": "Dana Lang",
    "email": "dana@acme.com",
    "company": "Acme"
  }'

Was this helpful?

Create customer

Authentication

Request body

Response

Example

Related pages