How to: Create a Participant Type

For information about prerequisites, see Creating Participants.

Assuming there are no Participants in the system, the first Participant that you need to create is a Participant Tenant. The Participant Tenant can be the owner of any other Participant. The Participant type request takes a singular and plural name for the Participant. For the Tenant Participant, which is also the master Participant, both the singular and plural names are the same. Let's create the tenant Participant and call it vehicle.

To create a Tenant Participant type, call the Create Participant Type endpoint and pass a request body similar to the following:

{
  "name": {
    "singular":"vehicle",
    "plural":"vehicles"
  },
  "category": [
    {
      "name": "twoWheeler",
      "description": "The participant vehicle has a category named twoWheeler.",
      "subCategory": [
        "gearless"
      ]
    }
  ],
    "callback": {
        "url": "https://www.examplecallback.com",
        "meta": {
            "key1": "Post ptp type"
        }
    }
}

📘
Note
By default all of the tenants that have been initialized already have a tenant participant type created so the above step can be skipped unless you are working with a tenant and initializing it from scratch

After the Participant of type Tenant is created, you can create the other Participant types that are going to be part of the operations.

The next Participant type to create is a type that you can use to represent all the mobile devices that the organization owns.

To create the mobiledevice Participant type, call the Create Participant Type endpoint and pass a request body similar to the following:


{
  "name": {
    "singular":"mobiledevice",
    "plural":"mobiledevices"
  },
  "category": [
    {
      "name": "Devices",
      "description": "Smart Phones used by drivers and warehouse employees.",
      "subCategory": [
        "Smartphones"
      ]
    }
  ],
    "callback": {
        "url": "https://www.examplecallback.com",
        "meta": {
            "key1": "Post ptp type"
        }
    }
}

📘Note

📘
Note