---
updatedAt: 2025-09-25T21:07:05.000Z
agentTools:
  projectIndex: https://developers.toriihq.com/llms.txt
---

# Using Postman to validate your JSON payload

A Postman collection with an example of the users and licenses JSON payload

This guide documents a Postman collection that can be used as a starting point to validate and test the JSON payload your integration will send to Torii.  The collection contains 4 pre-populated API calls with most of the data required to run the requests.

Click the **Run in Postman** button to access the collection.  The collection should be imported into your workspace.

[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/19631555-9c6c389b-3e02-4a51-a1cc-237adf8a64e3?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D19631555-9c6c389b-3e02-4a51-a1cc-237adf8a64e3%26entityType%3Dcollection%26workspaceId%3D0e91e34f-cc1a-4233-b040-d5ddb2c7aa90)

The environment specific variables that need to be set for your Torii account are documented below.

### Collection setup

1. At the **Sync Custom Integration** folder level, configure the variable that stores your Torii API key - **torii\_api\_key**.

<Image align="center" className="border" border={true} src="https://files.readme.io/c9c1167-image.png" />

### Running the requests in the collection

1. Configure the Get URL request by setting up the name query string parameter.

<Image align="center" className="border" border={true} src="https://files.readme.io/97dda17-image.png" />

2. Send the request and view the response data.

<Image align="center" className="border" border={true} src="https://files.readme.io/4608a4a-image.png" />

3. Copy the value of **url** from the previous step and paste it as the URL for the PUT request for **upload users and licenses**.

<Image align="center" className="border" border={true} src="https://files.readme.io/ffa1216-image.png" />

4. Review the sample JSON body and make any changes required to reflect the licenses for the application you would like to test.

<Image align="center" className="border" border={true} src="https://files.readme.io/eab89b6-image.png" />

```json Torii Users and Licenses JSON sample
{
    "users": [
        {
            "email": "max@demo-torii.com",
            "firstName": "Max",
            "lastName": "Bradley",
            "status": "active",
            "externalStatus": "active",
            "roles": [
                "Admin",
                "User"
            ],
            "lastUsedDate": ""
        },
        {
            "email": "sam@demo-torii.com",
            "firstName": "Sam",
            "lastName": "Johnsom",
            "status": "active",
            "externalStatus": "active",
            "roles": [
                "User"
            ],
            "lastUsedDate": ""
        },
        {
            "email": "jenny@demo-torii.com",
            "firstName": "Jenny",
            "lastName": "Wilson",
            "status": "active",
            "externalStatus": "active",
            "roles": [
                "User"
            ],
            "lastUsedDate": ""
        }
    ],
    "licenses": [
        {
            "name": "Professional",
            "unassignedAmount": 250,
            "users": [
                {
                    "email": "max@demo-torii.com",
                    "licenseStatus": "active",
                    "lastUsedDate": "2023-06-04T14:43:14Z"
                }
            ],
            "pricePerUser": 100000
        },
        {
            "name": "Collaborator",
            "unassignedAmount": 250,
            "users": [
                {
                    "email": "sam@demo-torii.com",
                    "licenseStatus": "active"
                },
                {
                    "email": "jenny@demo-torii.com",
                    "licenseStatus": "active"
                },
                {
                    "email": "max@demo-torii.com",
                    "licenseStatus": "active",
                    "lastUsedDate": "2023-09-04T14:43:14Z"
                }
            ],
            "pricePerUser": 50000
        }
    ]
}
```

5. Paste the **filePath** value returned in the response from **step 2** as the value for **path** in the Get File ID request.

<Image align="center" className="border" border={true} src="https://files.readme.io/0c59320-image.png" />

6. Send the request and view the response data that is returned.

![](https://files.readme.io/6f53849-image.png)

7. In your Torii console add a custom integration from the **Integrations** view.

<Image align="center" className="border" border={true} src="https://files.readme.io/36c16c3-image.png" />

8. Copy the app account id value that is returned once the integration has been added.

<Image align="center" className="border" border={true} src="https://files.readme.io/782cbd4-image.png" />

9. Setup the **Sync Integration** request by using the **id** from **step 6** and the **app account id** from step 8.

![](https://files.readme.io/6f4aa20-image.png)

10. Send the request and look for **sucess** set to **true** in the response.

<Image align="center" className="border" border={true} src="https://files.readme.io/a2a5691-image.png" />

11. Confirm the integration has synced successfully in the **Integrations** view of your Torii console.

<Image align="center" className="border" border={true} src="https://files.readme.io/0b2a959-image.png" />

12. Confirm the application's license information can be viewed in the **Licenses** view.