---
title: "card.pin_updated"
method: POST
path: "card.pin_updated"
tags: ["Event Types"]
---

# card.pin_updated

`POST card.pin_updated` (webhook)

Occurs when a card's PIN is set, changed, unblocked, or blocked due to excessive incorrect PIN attempts.

## Payload

- object
  - `event_type` 'card.pin_updated', required: The type of event that occurred.
  - `card_token` string, uuid, required: The token of the card whose PIN or PIN status was updated
  - `pin_status` 'OK' | 'BLOCKED', required: The card's PIN status after the update
  - `status_reason` 'PIN_SET' | 'PIN_CHANGED' | 'PIN_UNBLOCKED' | 'EXCESSIVE_PIN_ATTEMPTS', required: The reason for the PIN update: * `PIN_SET` - The PIN was set for the first time; `pin_status` is `OK` * `PIN_CHANGED` - The PIN was changed, including when changing a blocked PIN; `pin_status` is `OK` * `PIN_UNBLOCKED` - The PIN was unblocked without changing it; `pin_status` is `OK` * `EXCESSIVE_PIN_ATTEMPTS` - The PIN was blocked due to excessive incorrect PIN attempts; `pin_status` is `BLOCKED`

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.dev/lithic-com/apis/lithic-developer-api.md) - [All operations](https://skmtc.dev/lithic-com/apis/lithic-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lithic-com/apis/lithic-developer-api/revisions/17d2fbc28992?raw)