Sign in

v1

latestOpenAPI 3.1.0MIT-LICENSE2026-07-24113190543.3 KB
Customers

Create customer

The purpose of business is to create and keep a customer, you will learn what elements you need to create a customer. Remember the credit and debit card tokenization process: https://developers.conekta.com/page/web-checkout-tokenizer

post/customers

Headers

Accept-Language'es' | 'en'

Use for knowing which language to use

X-Child-Company-Idstring

In the case of a holding company, the company id of the child company to which will process the request.

Request body

corporateboolean

It is a value that allows identifying if the email is corporate or not.

custom_referencestring

It is an undefined value.

date_of_birthstring

It is a parameter that allows to identify the date of birth of the client.

emailstring email required

An email address is a series of customizable characters followed by a universal Internet symbol, the at symbol (@), the name of a host server, and a web domain ending (.mx, .com, .org, . net, etc).

default_payment_source_idstring

It is a parameter that allows to identify in the response, the Conekta ID of a payment method (payment_id)

default_shipping_contact_idstring

It is a parameter that allows to identify in the response, the Conekta ID of the shipping address (shipping_contact)

metadataobject
namestring required

Client's name

national_idstring

It is a parameter that allows to identify the national identification number of the client.

phonestring required

Is the customer's phone number

plan_idstring

Contains the ID of a plan, which could together with name, email and phone create a client directly to a subscription

Example request

{
  "antifraud_info": {
    "account_created_at": 1484040996,
    "first_paid_at": 1485151007
  },
  "date_of_birth": "24/07/1992",
  "email": "miguel@gmail.com",
  "default_payment_source_id": "src_1a2b3c4d5e6f7g8h",
  "default_shipping_contact_id": "ship_cont_1a2b3c4d5e6f7g8h",
  "fiscal_entities": [
    {
      "address": {
        "street1": "Nuevo Leon 254",
        "street2": "Departamento 404",
        "postal_code": "06100",
        "city": "Ciudad de Mexico",
        "state": "Ciudad de Mexico",
        "country": "MX",
        "residential": true
      },
      "company_name": "conekta"
    }
  ],
  "name": "miguel",
  "national_id": "HEGG560427MVZRRL04",
  "payment_sources": [
    {
      "type": "card | cash | spei | bnpl | pay_by_bank",
      "token_id": "tok_32hj4g234as"
    }
  ],
  "phone": "+5215555555555",
  "plan_id": "plan_987234823",
  "shipping_contacts": [
    {
      "phone": "+525511223344",
      "receiver": "Marvin Fuller",
      "between_streets": "Ackerman Crescent",
      "address": {
        "street1": "Nuevo Leon 254",
        "street2": "Departamento 404",
        "postal_code": "06100",
        "city": "Ciudad de Mexico",
        "state": "Ciudad de Mexico",
        "country": "MX",
        "residential": true
      }
    }
  ],
  "subscription": {
    "plan_id": "f84gdgf5g48r15fd21g8w424fd1",
    "card_id": "src_2qUCNd5AyQqfPMBuV",
    "trial_end": 1484040996
  }
}

Response

successful operation