---
title: "Register customer"
method: POST
path: "/customers"
---

# Register customer

`POST /customers`

Use this endpoint to register customers.

## Headers

- `Content-Type` string

## Request body

- object
  - `email` string, required — Customer's email
  - `locale` string, required — Defines language and text formatting for the user. E.g. "en_US", "fr_FR"
  - `country` string, required — 2-letter country code
  - `currency` string, required — Customer's currency. E.g. "USD", "EUR"
  - `password` string — Customer's password
  - `facebookId` string — Customer's FacebookId
  - `registrationDate` integer — Unix timestamp - Customer's registration date
  - `externalId` string — Customer's external ID
  - `firstName` string — Customer first name
  - `lastName` string — Customer last name
  - `externalData` object — Custom data in JSON format. You can store custom attributes of your choice here (for example, information about watched videos, percentage of completion). **Note:** it is not possible to report on this field.
  - `ipAddress` string — Customer IP address. Stored as the last customer IP address and customer IP address at registration. If not provided, it is taken from the request header. Both IPv4 and IPv6 addresses are accepted.
  - `taxIdentifier` string — The customer's tax identification number, e.g. a Brazilian CPF. Length 2–20. Example: `39053344705`
  - `phoneNumber` string — The customer's contact phone number. Length 2–20. Allowed characters only: digits and `+ - space ( ) .` Example: `+55 11 91234-5678`
  - `address` string — First line of the customer's street address. Non-empty when supplied. Example: `Avenida Paulista 1578`
  - `address2` string — Second line of the customer's address (apartment, suite, unit, etc.). Non-empty when supplied. Example: `Conjunto 42`
  - `dependentLocality` string — District within the city. Length 2–100. Example: `Bela Vista`
  - `city` string — City or town of the address. Example: `São Paulo`
  - `state` string — State, province, or region. Length 2–50. Example: `BR-SP`
  - `postalCode` string — Postal / ZIP code of the address. Length 2–20, upper-cased, validated against the country sent in the same request. Example: `01310-100`

## Response `200`

200

- object
  - `success` boolean
  - `data` object
    - `token` string
    - `id` integer
    - `email` string
    - `firstName` string
    - `lastName` string
    - `dateOfBirth` unknown
    - `country` string
    - `companyName` unknown
    - `phoneNumber` unknown
    - `addressLine1` unknown
    - `addressLine2` unknown
    - `city` unknown
    - `state` unknown
    - `postalCode` unknown
    - `regDate` string
    - `lastLoginDate` string
    - `transactions` string
    - `payment` unknown
    - `termsAccepted` string
    - `marketingOptIn` string
    - `lastUserIp` unknown
    - `externalId` string
    - `externalData` object
      - `active` integer
  - `message` string

---

[API](https://skmtc.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)