Create an Instrument Identifier {#tms-ii-tkn-create-intro}
==========================================================

This section describes how to create an instrument identifier.

Endpoint {#tms-ii-tkn-create-intro_section_bys_smk_dwb}
-------------------------------------------------------

**Test:** `POST ``https://apitest.cybersource.com``/tms/v1/instrumentidentifiers`{#tms-ii-tkn-create-intro_restcust-test}  
**Production:** `POST ``https://api.cybersource.com``/tms/v1/instrumentidentifiers`{#tms-ii-tkn-create-intro_prod-endpoint}  
**Production in India:** `POST ``https://api.in.cybersource.com``/tms/v1/instrumentidentifiers`{#tms-ii-tkn-create-intro_restcust-prod-india}  
**Production in Saudi Arabia:** `POST ``https://api.sa.cybersource.com``/tms/v1/instrumentidentifiers`{#tms-ii-tkn-create-intro_restcust-prod-ksa}  
**Test in Saudi Arabia:** `POST ``https://apitest.sa.cybersource.com``/tms/v1/instrumentidentifiers`{#tms-ii-tkn-create-intro_restcust-test-ksa}

Required Fields for Creating an Instrument Identifier {#tms-ii-tkn-create-reqfields}
====================================================================================

card.number
:
{#tms-ii-tkn-create-reqfields_dl_u12_vqy_dwb}

Related Information {#tms-ii-tkn-create-reqfields_section_jpc_xzz_sxb}
----------------------------------------------------------------------

* [API Field Reference for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/api-fields-about-guide.md "")
  {#tms-ii-tkn-create-reqfields_ul_kpc_xzz_sxb}

Optional Fields for Creating an Instrument Identifier {#tms-ii-tkn-create-optfields}
====================================================================================

bankAccount.number
:

bankAccount.routingNumber
:

billTo.address1
:

billTo.address2
:

billTo.administrativeArea
:

billTo.country
:

billTo.locality
:

billTo.postalCode
:

card.expirationMonth
:

card.expirationYear
:

card.securityCode
:

processingInformation.authorizationOptions.initiator. merchantInitiatedTransaction.previousTransactionID
:

Related Information {#tms-ii-tkn-create-optfields_section_jpc_xzz_sxb}
----------------------------------------------------------------------

* [API Field Reference for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/api-fields-about-guide.md "")
  {#tms-ii-tkn-create-optfields_ul_kpc_xzz_sxb}

REST Example: Creating a Card Instrument Identifier {#tms-ii-tkn-create-ex-rest}
================================================================================

Request

```
{
  "card": {
    "number": "4111XXXX11111111"
  }
}
```

{#tms-ii-tkn-create-ex-rest_codeblock_c51_vmt_gwb}  
Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "https://apitest.cybersource.com/tms/v1/instrumentidentifiers/7010000000016241111"
    },
    "paymentInstruments": {
      "href": "https://apitest.cybersource.com/tms/v1/instrumentidentifiers/7010000000016241111/paymentinstruments"
    }
  },
  "id": "7010000000016241111",
  "object": "instrumentIdentifier",
  "state": "ACTIVE",
  "card": {
    "number": "411111XXXXXX1111"
  },
  "metadata": {
    "creator": "testrest"
  }
}
```

REST Example: Creating a Bank Account Instrument Identifier {#tms-ii-tkn-create-ex-bank-rest}
=============================================================================================

Request

```keyword
POST https://apitest.cybersource.com/tms/v1/instrumentidentifiers
{
  "bankAccount": {
    "number": "4100",
    "routingNumber": "X71923284"
  }
}
```

{#tms-ii-tkn-create-ex-bank-rest_codeblock_c51_vmt_gwb} Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "https://apitest.cybersource.com/tms/v1/instrumentidentifiers/A7A91A2CA872B272E05340588D0A0699"
    },
    "paymentInstruments": {
      "href": "https://apitest.cybersource.com/tms/v1/instrumentidentifiers/A7A91A2CA872B272E05340588D0A0699/paymentinstruments"
    }
  },
  "id": "A7A91A2CA872B272E05340588D0A0699",
  "object": "instrumentIdentifier",
  "state": "ACTIVE",
  "bankAccount": {
    "number": "XXXX",
    "routingNumber": "X71923284"
  },
  "metadata": {
    "creator": "testrest"
  }
}
```

{#tms-ii-tkn-create-ex-bank-rest_codeblock_rbb_4rj_rwb}