Create an API key
- Sign in to Torq and open Workspace Settings > Security > API Keys.
- Select Create, then enter a name and an expiration date.
- Set Type to Service account and choose a role with the permissions your workflows need.
- Select Create, then save the Client ID and Client Secret. Torq shows the secret once.
Connect in Serval
- Open Integrations, find Torq, and choose Connect.
- Enter a Torq workspace name. This names the connection in Serval.
- Choose the Region you sign in to Torq from: US or EU. This can’t be changed later.
- Enter the Client ID and Client Secret, then connect.
Use the connection
Use the Torq connection in workflows to look up workflows and their runs, search and update cases, add case notes and comments, list users and roles, and read activity and audit logs. Serval can’t start a Torq workflow through this connection. Available APIs depend on the API key’s role.Troubleshooting
- Authentication fails: Check the client ID, the secret, the key’s expiration and the region. Update the Serval connection after replacing a key.
- An API returns 403: Check that the key’s role has the permission the request needs.
- Changing the region: A connection keeps the region it was created with. Add a new connection to use another region.
- Renaming the connection: Rename it from the connection’s details page, not while replacing its key.
- Replacing a key: Use a key from the same Torq workspace. A key from another workspace makes this connection’s workflows act in that workspace.
- Routing the connection through a self-hosted worker: Not supported for Torq. Torq is reached over the public internet, so the connection does not need a worker.

