---
title: "Create a customer"
method: POST
path: "/customers"
---

# Create a customer

`POST /customers`

Please note, one payment method field is required, either card, card_token or bank_account.

## Request body

- object
  - `first_name` string, required
  - `last_name` string, required
  - `reference` string, required
  - `email_address` string
  - `ip_address` string
  - `address` object
    - `address` string, required — Street number and name
    - `city` string, required
    - `state` string, required
    - `postcode` string, required
    - `country` string, required
  - `card` object
    - `card_holder` string, required
    - `card_number` string
    - `expiry_date` string
    - `cvv` string
  - `card_token` string — A card token can be sent through in lieu of the card data in the card array
  - `bank_account` object — The customer's bank account.
    - `account_name` string — Account name to be used for direct entry.
    - `account_number` string — Bank account number. 6-9 digits for an Australian bank account, or 8-10 digits for a New Zealand bank account
    - `bsb` string — BSB number - this will be in the format of ###-### for an Australian bank account, or ###### for a New Zealand bank account
    - `account_type` string — "AU" or "NZ" for Australian or New Zealand bank account. Defaults to "AU" if not provided.

## Response `201`

201

- object
  - `successful` boolean
  - `response` object
    - `id` string
    - `email` string
    - `reference` string
    - `first_name` string
    - `last_name` string
    - `created_at` string
    - `address` object
      - `address` string
      - `city` string
      - `state` string
      - `postcode` string
      - `country` string
    - `card_token` string
    - `card_number` string
    - `bank_account` unknown
    - `metadata` unknown
  - `errors` unknown[]
    - unknown
  - `test` boolean

---

[API](https://skmtc.net/fatzebra/apis/gateway.md) · [All operations](https://skmtc.net/fatzebra/apis/gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fatzebra/gateway/versions/6317ad424277/schema)