pilot

Step 1: Create a device {#tms-ctf-classic-step1}
================================================

This section describes how to create a device.

Endpoint
--------

**Test:** `POST ``https://apitest.visaacceptance.com``/tms/v2/devices`  
**Production:** `POST ``https://api.visaacceptance.com``/tms/v2/devices`

Required Fields for Creating a Device {#tms-ctf-classic-step1-reqfields}
========================================================================

clientDeviceID
:

clientDeviceName
:

category
:

operatingSytem.type
:

certificates\[\].buildId
:

certificates\[\].format
:

certificates\[\].value
:

Optional Fields for Creating a Device {#tms-ctf-classic-step1-optfields}
========================================================================

manufacturer
:

brand
:

model
:

operatingSytem.version
:

operatingSytem.buildId
:

REST Example: Creating a Device {#tms-ctf-classic-step1-ex-rest}
================================================================

Request

```
{
  "clientDeviceID": "A1234567890-0987654321",
  "clientDeviceName": "Kevins iPhone",
  "category": "PHONE",
  "manufacturer": "Apple",
  "brand": "iPhone",
  "model": "iPhone 15 Pro Max",
  "operatingSytem": {
    "type": "IOS",
    "version": "26.1",
    "buildId": "23B5044I"
  },
  "certificates": [
    {
      "usage": "SIGNATURE",
      "format": "X509_PEM",
      "value": "<Base64 URL-encoded Certificate>"
    }
  ]
}
```

{#tms-ctf-classic-step1-ex-rest_d9e24}  
Response to a Successful Request
A successful delete response returns an empty `HTTP 204 No Content` status.  
Response to a Successful Request

```
{
    "errors": [
        {
            "type": "forbidden",
            "message": "Request not permitted"
        }
    ]
}
```