Torq

Use these steps to handle integrations automatically within your workflows. This can help with tasks like automatically provisioning workspaces or rotating secrets:

- Create an integration
- Update an integration
- Delete an integration

These steps can be used to manage integrations in different workspaces according to the credentials provided by the Torq integration or access token.

Add the Create an integration step to your workflow.

Specify a meaningful name for the integration you want to create.

In the Integration type field, start typing the vendor name and select the vendor steps or trigger integration from the dropdown. The unique integration type is populated automatically according to your selection.

Once the integration type is selected, the step parameters list will be updated to include the relevant fields (required or optional) for creating the specified kind of integration. You can use <code>$.integrations.&lt;integration name&gt;.&lt;parameter&gt; </code>to access the credentials used for this type of integration in the current workspace. The credentials can also be saved as workspace secrets, retrieved from an external vault, and more.

Specify a <a href="https://kb.torq.io/en/articles/9145827-create-torq-api-keys-personal-settings-in-torq#h_206c984c08">Torq integration</a> or an access token to determine the workspace in which the integration will be created. To use an access token:

1. Use the Generate Access Token step, which requires a client ID and secret. 
2. In the Create an integration step, click the three-dot menu next to the Torq integration field and select Set values separately.
3. Provide the context path to the access token: <code>{{ $.generate_access_token.api_object.access_token }}</code>

For trigger integrations, the step output will include the integration webhook URL, which has to be provided to the third-party service to get trigger events.

1. Add the Create an integration step to your workflow.
2. Specify a meaningful name for the integration you want to create.
3. In the Integration type field, start typing the vendor name and select the vendor steps or trigger integration from the dropdown. The unique integration type is populated automatically according to your selection.

4. Once the integration type is selected, the step parameters list will be updated to include the relevant fields (required or optional) for creating the specified kind of integration. You can use <code>$.integrations.&lt;integration name&gt;.&lt;parameter&gt; </code>to access the credentials used for this type of integration in the current workspace. The credentials can also be saved as workspace secrets, retrieved from an external vault, and more.

5. Specify a <a href="https://kb.torq.io/en/articles/9145827-create-torq-api-keys-personal-settings-in-torq#h_206c984c08">Torq integration</a> or an access token to determine the workspace in which the integration will be created. To use an access token:
 1. Use the Generate Access Token step, which requires a client ID and secret. 
 2. In the Create an integration step, click the three-dot menu next to the Torq integration field and select Set values separately.
 3. Provide the context path to the access token: <code>{{ $.generate_access_token.api_object.access_token }}</code>

6. For trigger integrations, the step output will include the integration webhook URL, which has to be provided to the third-party service to get trigger events.

The Discard data execution option is set to Yes by default for this step, ensuring that any integration credentials, which may include sensitive data, aren't retained after the step execution. As a result, potentially sensitive information will not be accessible through the step execution log or any other system logs.

Create an Integration: How to Use