integrations

API reference descriptions are provided in English to preserve the exact published contract.

GETRead a contact's recent Shopify orderscontacts.shopifyOrders.list
GETRead the Shopify store connectionintegrations.shopify.list
DELETEDisconnect Shopifyintegrations.shopify.delete
POSTComplete Shopify authorizationintegrations.shopify.complete
POSTStart Shopify authorizationintegrations.shopify.connect

Read a contact's recent Shopify orders

GET/v1/accounts/{AC}/contacts/{CT}/shopify-orders

contacts.shopifyOrders.listSDK operation getV1AccountsByAcContactsByCtShopifyOrders

Required scope: contacts:read.

Parameters

CTstring (CT… SID)Required

GET /v1/accounts/{AC}/contacts/{CT}/shopify-orders

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/contacts/CT.../shopify-orders" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Read the Shopify store connection

GET/v1/accounts/{AC}/integrations/shopify

integrations.shopify.listSDK operation getV1AccountsByAcIntegrationsShopify

Required scope: accounts:read.

GET /v1/accounts/{AC}/integrations/shopify

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/integrations/shopify" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Disconnect Shopify

DELETE/v1/accounts/{AC}/integrations/shopify

integrations.shopify.deleteSDK operation deleteV1AccountsByAcIntegrationsShopify

Required scope: accounts:write.

Request body

stepUpTokenstring (max 256 chars)Required

DELETE /v1/accounts/{AC}/integrations/shopify

curl -X DELETE "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/integrations/shopify" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Content-Type: application/json" \
  -d '{
  "stepUpToken": "string"
}'

Responses

Complete Shopify authorization

POST/v1/accounts/{AC}/integrations/shopify/complete

integrations.shopify.completeSDK operation postV1AccountsByAcIntegrationsShopifyComplete

Required scope: accounts:write.Idempotency-Key required

Request body

queryobjectRequired

POST /v1/accounts/{AC}/integrations/shopify/complete

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/integrations/shopify/complete" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {}
}'

Responses

Start Shopify authorization

POST/v1/accounts/{AC}/integrations/shopify/connect

integrations.shopify.connectSDK operation postV1AccountsByAcIntegrationsShopifyConnect

Required scope: accounts:write.Idempotency-Key required

Request body

shopstring (max 128 chars)Required
stepUpTokenstring (max 256 chars)Required

POST /v1/accounts/{AC}/integrations/shopify/connect

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/integrations/shopify/connect" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "shop": "string",
  "stepUpToken": "string"
}'

Responses