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

# Create customer

`POST /customers`

Add new customer

## Request body

- object
  - `connection_id` integer, required
  - `first_name` string, required — First name for customer.
  - `last_name` string, required — Last name for customer.
  - `email` string, required — Email address of the customer. This is what creates a unique customer ID.
  - `phone` string — Telephone number of the customer.
  - `birthday` string, date — Customer birthdate. YYYY-MM-DD
  - `gender` string — Customer gender.
  - `pronoun_id` null | 1 | 2 | 3 | 4, nullable — * `1` - he/him * `2` - she/her * `3` - they/them * `4` - rather not say
  - `is_blacklist` boolean — Should the customer be blacklisted.
  - `is_fraud` boolean — Should the customer be flagged as fraud.
  - `tracking1` string — Custom Tracking Variable Option 1 for the customer
  - `tracking2` string — Custom Tracking Variable Option 2 for the customer
  - `tracking3` string — Custom Tracking Variable Option 3 for the customer
  - `tracking4` string — Custom Tracking Variable Option 4 for the customer
  - `tracking5` string — Custom Tracking Variable Option 5 for the customer
  - `tracking6` string — Custom Tracking Variable Option 6 for the customer
  - `tracking7` string — Custom Tracking Variable Option 7 for the customer
  - `tracking8` string — Custom Tracking Variable Option 8 for the customer
  - `tracking9` string — Custom Tracking Variable Option 9 for the customer
  - `tracking10` string — Custom Tracking Variable Option 10 for the customer
  - `tracking11` string — Custom Tracking Variable Option 11 for the customer
  - `tracking12` string — Custom Tracking Variable Option 12 for the customer
  - `tracking13` string — Custom Tracking Variable Option 13 for the customer
  - `tracking14` string — Custom Tracking Variable Option 14 for the customer
  - `tracking15` string — Custom Tracking Variable Option 15 for the customer
  - `tracking16` string — Custom Tracking Variable Option 16 for the customer
  - `tracking17` string — Custom Tracking Variable Option 17 for the customer
  - `tracking18` string — Custom Tracking Variable Option 18 for the customer
  - `tracking19` string — Custom Tracking Variable Option 19 for the customer
  - `tracking20` string — Custom Tracking Variable Option 20 for the customer

## Response `200`

OK

- object
  - `customer_id` integer
  - `connection_customer_id` string, nullable
  - `connection_id` integer
  - `first_name` string
  - `last_name` string
  - `email` string
  - `ip_address` string
  - `phone` string
  - `birthday` string, date, nullable
  - `gender` string
  - `pronoun_id` null | 1 | 2 | 3 | 4, nullable — * `1` - he/him * `2` - she/her * `3` - they/them * `4` - rather not say
  - `active_subscriber` boolean
  - `is_blacklist` boolean
  - `is_fraud` boolean
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `created_by` integer
  - `modified_by` integer
  - `customer_notes` string, nullable
  - `tracking1` string, nullable
  - `tracking2` string, nullable
  - `tracking3` string, nullable
  - `tracking4` string, nullable
  - `tracking5` string, nullable
  - `tracking6` string, nullable
  - `tracking7` string, nullable
  - `tracking8` string, nullable
  - `tracking9` string, nullable
  - `tracking10` string, nullable
  - `tracking11` string, nullable
  - `tracking12` string, nullable
  - `tracking13` string, nullable
  - `tracking14` string, nullable
  - `tracking15` string, nullable
  - `tracking16` string, nullable
  - `tracking17` string, nullable
  - `tracking18` string, nullable
  - `tracking19` string, nullable
  - `tracking20` string, nullable
  - `customer_cards` object[]
    - `customer_card_id` integer
    - `card_type_id` null | 1 | 2 | 3 | 4 | 5 | 6 | 7, nullable — * `1` - Mastercard * `2` - Visa * `3` - Discover * `4` - American Express * `5` - Digital Wallet * `6` - ACH * `7` - SEPA
    - `card_number` string
    - `card_exp_month` integer
    - `card_exp_year` integer
    - `card_prepaid` boolean
    - `date_created` string, date-time
    - `date_modified` string, date-time
    - `created_by` integer
    - `modified_by` integer
  - `customer_addresses` object[]
    - `customer_address_id` integer
    - `fname` string
    - `lname` string
    - `organization` string
    - `address1` string
    - `address2` string
    - `city` string
    - `country` string
    - `state` string
    - `zipcode` string
    - `address_valid` boolean
    - `date_created` string, date-time
    - `date_modified` string, date-time
    - `created_by` integer
    - `modified_by` integer

## Other responses

- `400` — Error response
- `401` — Unauthorized response
- `403` — Forbidden response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/versions/62037010356e/schema)