---
title: "Creates a new customer within your account"
method: POST
path: "/customers"
tags: ["Customers"]
---

# Creates a new customer within your account

`POST /customers`

This is for creating customers within your Ryft account (to enable features such as saved payment methods)

## Request body

- object — The request body for creating a customer
  - `email` string, email, required — The customer's email address. Note that these must be unique and are case insensitive
  - `firstName` string, nullable — The first name of the customer
  - `lastName` string, nullable — The last name of the customer
  - `homePhoneNumber` string, nullable — The home phone number of the customer. Must be in E.164 format
  - `mobilePhoneNumber` string, nullable — The mobile phone number of the customer. Must be in E.164 format
  - `metadata` object, nullable — use this parameter to attach key-value data to the customer. These will be sent with any associated customer events on your webhooks. You can have a maximum of 5 pieces of metadata.

## Response `200`

The customer was created successfully

- Customer
  - `id` string — The ID of the customer
  - `email` string, email — The customer's email address
  - `firstName` string, nullable — The first name of the customer
  - `lastName` string, nullable — The last name of the customer
  - `homePhoneNumber` string, nullable — The home phone number of the customer. In E.164 format
  - `mobilePhoneNumber` string, nullable — The mobile phone number of the customer. In E.164 format
  - `defaultPaymentMethod` string, nullable — The Id of the customer's preferred/default payment method
  - `metadata` object, nullable — use this parameter to attach key-value data to the customer. These will be sent with any associated customer events on your webhooks. You can have a maximum of 5 pieces of metadata.
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the customer was created

## Other responses

- `400` — One or more inputs are invalid
- `409` — This operation has already been performed
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)