---
title: "POST /network-tokens"
method: POST
path: "/network-tokens"
tags: ["NetworkTokens"]
---

# POST /network-tokens

`POST /network-tokens`

## Request body

- CreateNetworkTokenRequest
  - `data` Card
    - `number` string, nullable
    - `expiration_month` integer, nullable
    - `expiration_year` integer, nullable
    - `cvc` string, nullable
  - `token_id` string, nullable
  - `token_intent_id` string, nullable
  - `expiration_month` integer, nullable
  - `expiration_year` integer, nullable
  - `cardholder_info` CardholderInfo
    - `name` string, nullable
    - `address` Address
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `postal_code` string, nullable
      - `city` string, nullable
      - `state_code` string, nullable
      - `country_code` string, nullable
  - `merchant_id` string, uuid, nullable
  - `configuration_merchant_id` string, uuid, nullable
  - `owner_merchant_id` string, uuid, nullable

## Response `201`

Created

- NetworkToken
  - `id` string, nullable
  - `tenant_id` string, uuid
  - `data` Card
    - `number` string, nullable
    - `expiration_month` integer, nullable
    - `expiration_year` integer, nullable
    - `cvc` string, nullable
  - `card` CardDetails
    - `bin` string, nullable
    - `last4` string, nullable
    - `expiration_month` integer, nullable
    - `expiration_year` integer, nullable
    - `brand` string, nullable
    - `funding` string, nullable
    - `authentication` string, nullable
    - `issuer` CardIssuer
      - `country` string, nullable
      - `name` string, nullable
    - `issuer_country` CardIssuerCountry
      - `alpha2` string, nullable
      - `name` string, nullable
      - `numeric` string, nullable
    - `segment` string, nullable
    - `product` CardProduct
      - `code` string, nullable
    - `additional` AdditionalCardDetails[], nullable
      - `brand` string, nullable
      - `funding` string, nullable
      - `authentication` string, nullable
      - `issuer` CardIssuer
        - `country` string, nullable
        - `name` string, nullable
  - `network_token` CardDetails
    - `bin` string, nullable
    - `last4` string, nullable
    - `expiration_month` integer, nullable
    - `expiration_year` integer, nullable
    - `brand` string, nullable
    - `funding` string, nullable
    - `authentication` string, nullable
    - `issuer` CardIssuer
      - `country` string, nullable
      - `name` string, nullable
    - `issuer_country` CardIssuerCountry
      - `alpha2` string, nullable
      - `name` string, nullable
      - `numeric` string, nullable
    - `segment` string, nullable
    - `product` CardProduct
      - `code` string, nullable
    - `additional` AdditionalCardDetails[], nullable
      - `brand` string, nullable
      - `funding` string, nullable
      - `authentication` string, nullable
      - `issuer` CardIssuer
        - `country` string, nullable
        - `name` string, nullable
  - `par` string, nullable
  - `status` string, nullable
  - `created_by` string, uuid
  - `created_at` string, date-time
  - `modified_by` string, uuid, nullable
  - `modified_at` string, date-time, nullable
  - `token_id` string, nullable
  - `token_intent_id` string, nullable
  - `_extras` NetworkTokenExtras
    - `deduplicated` boolean, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Client Error
- `500` — Server Error

---

[API](https://skmtc.net/basistheory/apis/basis-theory-api.md) · [All operations](https://skmtc.net/basistheory/apis/basis-theory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basistheory/basis-theory-api/revisions/cbb8e098b560/schema)