Update integrations

PATCH

/account/integrations

curl --request PATCH \
  --url https://app.stoqapp.com/api/v2/external/account/integrations \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <X-Auth-Token>' \
  --data '{ "klaviyo": "string", "omnisend": "string", "mailchimp": "string", "shopify": "string", "sync_customers_tag": "string", "meta_pixel": "string", "flow_triggers": "string", "split_order_app": "string" }'

• Production

Update the shop’s integrations: sync signups to Klaviyo, Omnisend, Mailchimp or Shopify customers (with the customer tag), the Omnisend and Mailchimp API keys and Mailchimp audience, the Meta Pixel, Shopify Flow triggers and the SplitOrder app switch. API keys are write only; reads return connected flags.

Note: Deep partial. omnisend.api_key and mailchimp.api_key are never returned by any read; an empty string removes the saved key. A Mailchimp key is checked by fetching the account’s audiences and is not saved when Mailchimp refuses it; mailchimp.list_id must be one of those audiences. Klaviyo connects with OAuth from the Integrations page; this action only turns its sync on or off. flow_triggers.triggers replaces the stored list.

Authorizations

• ApiKeyAuth

Request Body^required

Media typeapplication/json

object

klaviyo

omnisend

mailchimp

shopify

sync_customers_tag

meta_pixel

flow_triggers

split_order_app

Example

{
  "klaviyo": "string",
  "omnisend": "string",
  "mailchimp": "string",
  "shopify": "string",
  "sync_customers_tag": "string",
  "meta_pixel": "string",
  "flow_triggers": "string",
  "split_order_app": "string"
}

Responses

200

Success — the updated resource.

Media typeapplication/json

object

Example ^generated

{}

202

Accepted — async/bulk work was queued. Poll the returned job.

Media typeapplication/json

Returned for async/bulk work — poll the job until it reaches a terminal state.

object

job_id

string

status_url

string

Example

{
  "job_id": "job_a1b2c3",
  "status_url": "/api/v2/external/jobs/job_a1b2c3"
}

401

Missing or invalid X-Auth-Token.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "Unauthorized"
  ]
}

422

The request failed validation.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "name is required"
  ]
}

429

Rate limited — cost-weighted per token (read 1, write 2; 360 points / 60s). Check Retry-After.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "Rate limit exceeded"
  ]
}