Adding your Oomnitza API credentials to the vault

Create custom asset and user workflows that use our internal Oomnitza API. Before you get started creating the workflows, you first need to create an Oomnitza API token and add it to the vault.

Did you know?
The Oomnitza block is also a convenient way to access our internal Oomnitza APIs. The Oomnitza block provides you with a unified view of all internal Oomnitza APIs, including the APIs used in the custom asset and user workflows. For more information, refer to the Oomnitza block.

Creating an Oomnitza API token

To generate an API token in Oomnitza, complete these steps:

1. Click Configuration > Security > API tokens.
2. Click + to add a new token.
3. Enter the name of the token.
4. Enter the name of the user to whom the token will be assigned.
5. Click SUBMIT. 

The API token is displayed once and cannot be recovered.

For further information, refer to Creating an API token

Next, add your API token to the vault in Oomnitza.

Adding the credentials to the vault

To stream data into Oomnitza, complete the following steps:

1. In Oomnitza, click Configuration>Security>Credentials.
2. Click Add new credential(+).
3. Add the information details.
4. Click the AUTHORIZATION tab.
5. Ensure that API Key is selected as the Authorization type.
6. Ensure that the Token Name is Authorization2. 
7. Enter your Oomnitza API token.
8. Ensure that Add to Header is selected.
9. Click CREATE. 

To save time entering information when you create workflows, we recommend that you also add the Oomnitza subdomain as a global variable in Oomnitza.

Setting the Oomnitza subdomain as a global variable

1. Click Configuration>General.
2. Click Global Settings.
3. Click Add new variable (+). 
4. Enter Oomnitza.Subdomain as the key value.
5. Enter the global variable for the subdomain. If your Oomnitza URL is https://mycompany.oomnitza.comyour subdomain is mycompany.
6. Save your changes.

Next steps

Creating workflows for Oomnitza users

Creating workflows for Oomnitza assets