---
title: "Create a customer"
method: POST
path: "/customers"
tags: ["Customers"]
---

# Create a customer

`POST /customers`

Creates a new customer for the authenticated company.

Use customers to store and reuse buyer information (for example name, email, phone, and addresses).
The created customer can be referenced later when creating orders and other resources.

## Headers

- `Accept-Language` 'es' | 'en'
- `X-Child-Company-Id` string

## Request body

- Customer — Customer create request.
  - `name` string, required — Customer's name.
  - `email` string, email, required — Customer email address.
  - `phone` string, nullable — Customer phone number.
  - `corporate` boolean — Indicates whether the customer email is corporate.
  - `custom_reference` string — Merchant-defined reference used to identify the customer in your system.
  - `metadata` object — Arbitrary metadata associated with the customer.
  - `payment_sources` CustomerPaymentMethodsRequest[] — Customer payment sources to be created with the customer (optional).
    - `type` string, required — Type of payment method.
    - `expires_at` integer — Expiration date as unix timestamp (seconds).
  - `fiscal_entities` CustomerFiscalEntitiesRequest[] — Customer fiscal entities to be created with the customer (optional).
    - `address` CustomerAddress, required
      - `street1` string, required
      - `street2` string
      - `postal_code` string, required
      - `city` string, required
      - `state` string
      - `country` string, required — this field follows the [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
      - `residential` boolean
      - `external_number` string
    - `tax_id` string
    - `name` string
    - `email` string
    - `phone` string
    - `metadata` object
  - `shipping_contacts` CustomerShippingContacts[] — Customer shipping contacts to be created with the customer (optional).
    - `phone` string — Phone contact
    - `receiver` string — Name of the person who will receive the order
    - `between_streets` string — The street names between which the order will be delivered.
    - `address` CustomerShippingContactsAddress, required — Address of the person who will receive the order
      - `street1` string
      - `street2` string
      - `postal_code` string
      - `city` string
      - `state` string
      - `country` string — this field follows the [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
      - `residential` boolean, nullable
    - `parent_id` string
    - `default` boolean, nullable
    - `deleted` boolean, nullable
    - `metadata` object — Metadata associated with the shipping contact

## Response `200`

successful operation

## Other responses

- `401` — authentication error
- `402` — payment required error
- `422` — parameter validation error
- `500` — internal server error

---

[API](https://skmtc.net/digitalfemsa/apis/femsa-api.md) · [All operations](https://skmtc.net/digitalfemsa/apis/femsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalfemsa/femsa-api/versions/2e43caddf36b/schema)