Opal’s integration with Tray.ai allows you to manage access to the Tray.ai organization and workspaces.
Supported resources
Requirements
Before you begin, you must:
- Be an Opal Admin
- Be on version
1.1256.0, if you self-host Opal
1. Create a Tray API user and API token
To allow Opal to access and manage your Tray roles and workspaces, you must first create an API token. You will only be shown the API token on creation, so save it for the next steps.
In Account Settings > Tokens under API users select the Create API user option:
- Name: A suitable name
- Organization role: Either is fine, as you will edit it later
- Workspace: Any workspace
- Workspace Role: Any role
Once you click the Next button, a new window will open for creating an API token.
Provide a suitable Token name and set token expiration period.
Make sure to copy and save the newly created token securely.
You will not be able to view the token again.
Once this is done, edit the API user’s organization role and workspace role and set it to admin
2. Create Tray.ai app in Opal
In Opal, go to Inventory > +App and select Tray. Name your Tray app, provide a description, and enter the API token you generated in step 1.
After you save the app, you can import workspaces and roles from … > Import items.
Organization management
Once a user is synced from Tray into Opal, admins can manage the user’s access level (admin, member or guest). Opal does not support user provisioning for Tray.ai, so users cannot be added or removed from the Tray organization through Opal. Last modified on November 16, 2026