Adding Operators to your site is necessary to populate the users who will be running the Apps developed in Tulip. Operators can traditionally be made in the People tab. You can also create these operators using an external system via the Tulip API.

Adding an Operator Bot

In your Tulip site, navigate to your profile in the top right corner.

Select the Settings options from this menu.

Within Settings, select the Bots option.

On the right side of this page, select Create Bot.

In the Creation, give the Bot a name and make sure it has the Users:Write scope selected, then click Create.

Note: Make sure to save the Bot information for the API Key, Secret, and Authorization Header.

Using the Operator API

The following will go through how to create an operator. In this case, the example will use Postman to perform the creation.

First, add your API endpoint to the Post request.

Then, under Authorization, select Basic Auth and plug in the API Key as the Username, and the API Secret as the Password.

Under Headers, add the Auth Header.

In the Body, format the request to take in the JSON object. The generic format for this request is as follows.

{

"role": "operator",

"name": "string",

"badge_id": "string"

}

This will look something like this:

Hit send to run the request, and you will receive a 201 response to indicate success. To verify, you can head over to the People tab to make sure the user was successfully created.

If the request failed, make sure to check the Key and Secret are correct. For more information on specific response codes, check out the API Documentation section on the Bots page.

Did this answer your question?