---
title: "Notify Binding Creation"
method: POST
path: "/notify-binding-creation"
tags: ["Binding notifications"]
---

# Notify Binding Creation

`POST /notify-binding-creation`

Notify the token requestor about a device binding creation. 

In case of retryable error returned by the token requestor, the notification will be resent periodically with exponential backoff.

## Parameters

- `#/parameters/authorization` — unresolved $ref
- `#/parameters/xCorrelationId` — unresolved $ref

## Request body

- object
  - `tokenId` string, required — Identifier of the token
  - `deviceId` string, required — The Device Identifier. Unique for each device.
  - `deviceType` number — Device type. |value|description| |-------|-------| |1|Phone| |2|Tablet| |3|Watch| |4-99|RFU|
  - `appType` 'IOS' | 'ANDROID' | 'WEB' — The device type.
  - `vProvisionedTokenId` string — Specific to Visa. Another token identifier that shall be used only with Visa Cloud Token Framework.
  - `selectedIdvMethod` 'OTP_SMS' | 'OTP_EMAIL' | 'OTP_ONLINE_BANKING' | 'APP_TO_APP' | 'OUTBOUND_CALL' | 'CUSTOMER_SERVICE' | 'NONE' | 'UNKNOWN', required — The ID&V method selected to bind the device.
  - `merchantId` string, required — Identifier of the merchant provided by Thales at on-boarding.
  - `creationTimestamp` string — Token or binding creation timestamp compliant with ISO 8601.

## Other responses

- `204` — unresolved $ref
- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref
- `503` — unresolved $ref

---

[API](https://skmtc.dev/thalescloud/apis/d1-oauth-api.md) · [All operations](https://skmtc.dev/thalescloud/apis/d1-oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thalescloud/d1-oauth-api/revisions/96089514858c/schema)