Skip to main content
GET
/
integrations
/
{integrationId}
Retrieve a single integration
curl --request GET \
  --url https://production.runalloy.com/integrations/{integrationId} \
  --header 'Authorization: <authorization>' \
  --header 'x-api-version: <x-api-version>'
"{\n    \"data\": {\n        \"integrationId\": \"66326843cc9cdb107221f222\",\n        \"app\": \"Shopify\",\n        \"installed\": false,\n        \"icon\": \"https://cdn.runalloy.com/icons/shopify.png\",\n        \"workflows\": [\n            {\n                \"workflowId\": \"66326849cc9cdb107221f342\",\n                \"name\": \"Untitled Workflow #346\",\n                \"installed\": false,\n                \"active\": false,\n                \"version\": 1,\n                \"connectors\": [\n                    {\n                        \"name\": \"On Installation Trigger\",\n                        \"id\": \"4762a899-8f38-44d9-a091-f4b6eaba386e\",\n                        \"connector\": \"onInstallationTrigger\",\n                        \"icon\": \"https://cdn.runalloy.com/icons/OnIntegrationInstallation.svg\",\n                        \"subtitle\": \"On Installation Trigger\"\n                    },\n                    {\n                        \"name\": \"Shopify\",\n                        \"id\": \"0679a48c-e0f9-455a-91f2-48a739bac9d7\",\n                        \"connector\": \"shopify\",\n                        \"icon\": \"https://cdn.runalloy.com/icons/shopify.png\",\n                        \"subtitle\": \"Gets a list of all Products\"\n                    },\n                    {\n                        \"name\": \"Shopify\",\n                        \"id\": \"24ed5879-4aa9-4a2c-b8dc-afe6413c1ca7\",\n                        \"connector\": \"shopify\",\n                        \"icon\": \"https://cdn.runalloy.com/icons/shopify.png\",\n                        \"subtitle\": \"Shopify\"\n                    }\n                ]\n            }\n        ],\n        \"credentials\": [\n            \"shopify\"\n        ]\n    }\n}\n"

Headers

​
Authorization
string
default:bearer YOUR_API_KEY
required
​
x-api-version
string
default:2025-09
required

The version of the API to use. The current API version is 2025-09.

Path Parameters

​
integrationId
string
required

This API parameter allows you to filter results based on the integrationId or the integrationName (also referred to as 'app'). The integration name (app) is a custom name that you have set for your integration. When using the integration name (app), provide the name of the integration you want to filter for (e.g. 'shopify order sync' or 'magento product creation'). You can obtain the integration name (app) from the List Integrations endpoint under the 'app' parameter, or by checking your UI. Either integrationId or integrationName must be provided but it cannot be both.

Query Parameters

​
userId
string
required

The Id used to identify the user. Note: you can also use the Embedded user's username in this field.

Response

200

​
data
object
⌘I