Overview
Torii integrates with ChatGPT and syncs:
- People in your ChatGPT Enterprise workspace — their name, email, role, and seat type.
- The groups each person belongs to.
You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
To connect this integration, we require the following:
Accounts & Permissions
- You must have the Owner or Admin role in the ChatGPT workspace you want to connect.
- Admin keys are only available for eligible managed ChatGPT workspaces (ChatGPT Enterprise, Edu, and ChatGPT for Healthcare workspaces).
Required keys
- Workspace ID — the unique ID of your ChatGPT workspace.
- Admin API Key — a workspace-scoped Admin key created in ChatGPT’s Admin Console.
How to Generate the Required Values
Step 1: Find your Workspace ID
- In ChatGPT, select your profile icon, then select Workspace settings.
- Go to General.
- Copy the workspace identifier shown there — this is your Workspace ID.
Step 2: Create an Admin API Key
Torii only needs read access to your workspace’s users and groups. Create the Admin key with the smallest permissions that cover that, rather than a full-access key.
- Sign in to Admin Console with an account that has the Owner or Admin role for the workspace you want to connect.
- Select your tenant if prompted, then select the ChatGPT workspace you want to connect.
- Open Credentials, then select Admin keys.
- Select Create new admin key and give it a descriptive name (for example, “Torii”).
- Choose an expiration. Admin keys can default to Never expire — set an expiration your organization is comfortable with, or leave it as Never if that matches your policy.
- Choose the permissions:
- Select Custom permissions.
- Set Users to Read.
- Set Group Management to Read.
- Leave every other category at None.
- Select Submit.
Important
Your Admin API Key is shown only once, right after you create it. Copy it and store it somewhere safe before you leave the page — you won’t be able to view it again.
If you can’t create a Custom key: Workspace admins (as opposed to workspace owners) may not see every permission category, and some organizations restrict key creation to owners. If a Custom option isn’t available to you, you can instead create a key with the All permissions preset — this works, but it grants Torii more access than it actually needs. Use Custom whenever it is available to you.
A key created by someone who later loses Admin or Owner access to the workspace, or is deactivated, stops working — plan for who on your team owns this key.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for ChatGPT and click Connect.
- Enter your Workspace ID and Admin API Key.
- Click Connect.
Q&A
Q: We use more than one ChatGPT workspace — can Torii connect all of them?
A: Yes, but each connection covers exactly one ChatGPT workspace. If your organization has several ChatGPT workspaces, connect each one separately with its own Workspace ID and Admin API Key.
Q: How are ChatGPT licenses counted?
A: Separately by seat type. ChatGPT seats and Codex seats are paid for separately, so Torii reports them as separate license counts instead of combining them into one number.
Q: If someone is removed from our ChatGPT workspace, will Torii show them as removed?
A: No — they will simply stop appearing in the synced user list. ChatGPT’s API only returns people who are currently active members; it does not report who was removed. If you have a workflow that waits for a user’s status to change to “removed” or “deleted” before taking action, it will not be triggered by a ChatGPT removal — the person just disappears from the next sync instead.
For any further questions, please contact Torii Support.