---
title: "Create a PIN"
method: POST
path: "/v2/profiles/{profileId}/pin"
tags: ["sca-pin"]
---

# Create a PIN

`POST /v2/profiles/{profileId}/pin`

Creates a new PIN factor used to resolve a SCA knowledge challenge type.

The request and response are encrypted using the JOSE framework. Please refer to the [SCA over API guide](/guides/developer/auth-and-security/sca-over-api) to understand how encryption and decryption work.

## Path parameters

- `profileId` integer, required

## Headers

- `Accept` string, required
- `Accept-Encoding` string, required
- `Content-Encoding` string, required
- `X-tw-jose-method` string, required
- `X-External-Correlation-Id` string, uuid

## Response `200`

The PIN has been successfully created.

## Other responses

- `409` — A PIN has already been created for this profile.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)