> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usezentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Card

> Issue a card for a tenant customer

Create a card for a customer under your tenant.

## HTTP Request

`POST /api/v1/cards`

## Request Body

```json theme={null}
{
  "customer_id": "8dca347a-3b14-4d1a-a5c4-35c8b07d52ab",
  "card_type": "virtual",
  "provider": "auto",
  "currency": "NGN",
  "single_use": false,
  "geofence_enabled": false,
  "geofence_max_distance_km": 250
}
```

## Supported Fields

* `customer_id` required
* `card_type` optional, defaults to `virtual`
* `provider` optional, defaults to `auto`
* `currency` optional, defaults to `NGN`
* `single_use` optional, defaults to `false`
* `geofence_enabled` optional, defaults to `false`
* `geofence_max_distance_km` optional

## Response

Returns the issued card record as currently exposed by the card issuing service.

## Notes

* `type` is accepted as an alias for `card_type`.
* `customerId` is accepted as an alias for `customer_id`.
* Network-brand selection fields such as `brand`, plus fields like `funding_amount` and `spending_limits`, are not part of the current backing service contract for this endpoint.
