---
title: "Set a PIN for a reference using a voicemail box"
method: PUT
path: "/v2/partition/{partitionId}/account/{accountId}/voicemailbox/{voicemailBoxId}/pin"
tags: ["Voicemail Box"]
---

# Set a PIN for a reference using a voicemail box

`PUT /v2/partition/{partitionId}/account/{accountId}/voicemailbox/{voicemailBoxId}/pin`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/voicemailbox/{voicemailBoxId}/pin`
- Auth: API key in header `X-AUTH-TOKEN`

## Path parameters

- `partitionId` string, required
- `accountId` string, required
- `voicemailBoxId` string, required

## Request body

- PinChange
  - `accountId` string
  - `voicemailBoxId` string
  - `referenceId` string
  - `referenceType` string
  - `pin` string

## Response `200`

Successful operation

## Other responses

- `400`: Invalid request

---

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