---
title: "Create a credit/debit card entry for a customer"
method: POST
path: "/v3/merchants/{mId}/customers/{customerId}/cards"
tags: ["CUSTOMERS"]
---

# Create a credit/debit card entry for a customer

`POST /v3/merchants/{mId}/customers/{customerId}/cards`

## Request

- Base URL: `https://apisandbox.dev.clover.com`
- URL: `https://apisandbox.dev.clover.com/v3/merchants/{mId}/customers/{customerId}/cards`
- Auth: HTTP bearer

"first6" and "last4" fields are required.

## Path parameters

- `mId` string, required
- `customerId` string, required

## Headers

- `User-Agent` string, required

## Request body

- object: Card details of the customer.
  - `id` string: Card identifier.
  - `first6` string, required: First 6 digits of the customer's card.
  - `last4` string, required: last 4 digits of the customer's card.
  - `firstName` string: First name on the customer's card.
  - `lastName` string: Last name on the customer's card.
  - `expirationDate` string: Expiry date of the customer's card.
  - `additionalInfo` object: Additional information for the customer's card.
    - `default` string
  - `cardType` string: Customer's card type.
  - `token` string: Customer's card token number. Note: Token length cannot be more than 72 characters.
  - `tokenType` 'MULTIPAY' | 'FINANCIAL' | 'CTOKEN': Customer's card token type.
  - `modifiedTime` integer: Time when the card was last updated.
  - `customer` object: Customer who this card belongs to.
    - `id` string: Unique identifier.

## Response `200`

---

[API](https://skmtc.dev/clover/apis/platform-api.md) - [All operations](https://skmtc.dev/clover/apis/platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clover/apis/platform-api/revisions/95fd9ec401ef?raw)