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

# Create a customer

`POST /v1/customers`

Create a PowerBoard customer entity

## Headers

- `x-user-secret-key` string, required
- `Content-Type` string, required

## Request body

- object
  - `reference` string — A manually defined reference for the customer creation request
  - `first_name` string — The customer's first name
  - `last_name` string — The customer's last name
  - `email` string — The customer's email address.
  - `phone` string — The customer's phone number
  - `payment_source` object
    - `gateway_id` string — The gateway ID of the gateway being used for this transaction. I.e. The PowerBoard gatewayID of mastercard service
    - `vault_token` string — The vault token of a customer
    - `vault_token_reference` string
    - `card_name` string — The name of the cardholder
    - `card_number` string — The card number of the card being used in the charge
    - `expire_month` string — The expiry month of the card
    - `expire_year` string — The expiry year of the card
    - `card_ccv` string — The CCV of the card
    - `address_line1` string — Customer's address line1
    - `address_line2` string — Customer's address line2
    - `state` string — Customer's address state
    - `country` string — Customer's address country
    - `city` string — Customer's address city
    - `postcode` string — Customer's address postcode
  - `description` string — Manually defined reference for customer in payment systems
  - `token` string, required — One-time token returned from the PowerBoard widget

## Response `200`

200

- object
  - `status` integer
  - `error` unknown
  - `resource` object
    - `type` string
    - `data` object
      - `__v` integer
      - `created_at` string
      - `updated_at` string
      - `default_source` string
      - `_id` string
      - `payment_destinations` object[]
      - `payment_sources` object[]
        - `_id` string
        - `updated_at` string
        - `vault_token` string
        - `expire_month` integer
        - `expire_year` integer
        - `card_name` string
        - `card_number_last4` string
        - `card_number_bin` string
        - `card_scheme` string
        - `ref_token` string
        - `status` string
        - `created_at` string
        - `gateway_id` string
        - `type` string
      - `statistics` object
        - `total_collected_amount` integer
        - `successful_transactions` integer
      - `_service` object
        - `default_gateway_id` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/commbank/apis/powerboard-api.md) · [All operations](https://skmtc.dev/commbank/apis/powerboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/commbank/powerboard-api/revisions/2ef3ed32f8c2/schema)