---
title: "Provision a Network Token"
method: POST
path: "/payment/instruments/{instrumentId}/provisionNetworkToken"
tags: ["Instruments"]
---

# Provision a Network Token

`POST /payment/instruments/{instrumentId}/provisionNetworkToken`

Provision a network token for a given payment instrument.

## Path parameters

- `instrumentId` string, uuid, required

## Headers

- `x-idempotency-key` string, uuid, required

## Request body

- object
  - `providerConfigId` string, uuid — Optional. The ID of the network token provider config to use for provisioning. When provided, the network token will be provisioned using the specified provider config. When omitted, the default network token provider config is used.

## Response `200`

Success.

- object
  - `success` boolean — Whether or not a network token was successfully provisioned.
  - `result` string — Result of the operation according to Payrails mapping from the provider response.
  - `resultDetail` string — Additional details of the operation result according to Payrails mapping from the provider response.
  - `errors` string[]

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `404` — Not Found.
- `429` — Too Many Requests.

---

[API](https://skmtc.net/payrails/apis/payrails-api-reference.md) · [All operations](https://skmtc.net/payrails/apis/payrails-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payrails/payrails-api-reference/revisions/9dd2f0158582/schema)