---
title: "Create Card PIN Update URL"
method: POST
path: "/customers/{customerID}/card_accounts/{cardAccountID}/pin"
tags: ["Cards"]
---

# Create Card PIN Update URL

`POST /customers/{customerID}/card_accounts/{cardAccountID}/pin`

## Request

- Base URL: `https://api.bridge.xyz/v0`
- URL: `https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/pin`
- Auth: API key in header `Api-Key`

Generates a URL that can be used to render a secure frame to update the PIN for a card account. The URL is single-use and time-limited.

## Path parameters

- `customerID` string, required: A UUID that uniquely identifies a resource
- `cardAccountID` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Response `200`

URL to update the card PIN

- CardPinUpdateResponse: Response containing a secure URL to update a card's PIN
  - `url` string, uri, required: Single-use, time-limited URL that can be used to securely update the card PIN in an iframe

## Other responses

- `400`: Request containing missing or invalid parameters.
- `401`: Missing or invalid API key
- `500`: Unexpected error. User may try and send the request again.

---

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