---
title: "POST /api/customer/create"
method: POST
path: "/api/customer/create"
---

# POST /api/customer/create

`POST /api/customer/create`

Create or update a customer

## Headers

- `x-api-key` string

## Request body

- object
  - `customerData` CustomerObject
    - `email` string, email, required — The email of the user or lead. *Must be unique.
    - `firstName` string — The first name of the user or lead.
    - `lastName` string — The last name of the user or lead.
    - `title` string — The user's title (e.g. CEO, CTO, Mr, etc.).
    - `phoneNumber` string — The phone number of the user or lead.
    - `organization` string — The organization of the user or lead (e.g. company name).
    - `website` string — The user's website.
    - `address` string — The user's address.
    - `city` string — The user's city.
    - `state` string — The user's state.
    - `zip` string — The user's zip code.
    - `country` string — The user's country.
    - `billingAddress` string — The user's billing address.
    - `billingCity` string — The user's billing city.
    - `billingState` string — The user's billing state.
    - `billingZip` string — The user's billing zip code.
    - `billingCountry` string — The user's billing country.
    - `subscriptionType` string — The user's subscription type.
    - `socialMediaHandles` object[] — The user's social media handles.
      - `platform` string — The social media platform (e.g. facebook, twitter, tiktok, linkedin, etc.).
      - `handle` string — The user's handle on the social media platform (e.g. johndoe).
    - `notes` string — Any additional notes for the user or lead.
    - `customFields` object[] — The user's custom fields.
      - `name` string — The name of the custom field.
      - `value` string — The value of the custom field.

## Response `200`

Customer data processed successfully

- object
  - `success` boolean

## Other responses

- `400` — Missing required fields
- `401` — No API key or token provided
- `500` — Internal server error

---

[API](https://skmtc.dev/usersketch/apis/usersketch-api.md) · [All operations](https://skmtc.dev/usersketch/apis/usersketch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usersketch/usersketch-api/revisions/d53c94e971a4/schema)