List the integrations
const url = 'https://api.connectato.com/v1/integrations?sort=created_at';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.connectato.com/v1/integrations?sort=created_at' \ --header 'Authorization: Bearer <token>'Scope: read_integrations.
The organization’s connected apps: stores, courier and invoicing
accounts, email and SMS providers, disconnected ones included (status
disconnected), so a client syncing by updated_since sees an account
removed. filter[status][is_not]=disconnected keeps the installed ones.
Authorizations
Section titled "Authorizations"Parameters
Section titled "Parameters"Query Parameters
Section titled "Query Parameters"Items per page. Default: 50.
The previous page’s next_cursor, with the same filter, sort and updated_since.
The order; - before a key for descending. Default: -created_at.
Only what changed at or after this moment (RFC 3339), read in sort=updated_at.
One or more codes, comma-separated (filter[category]=a,b), or filter[category][is_not]=a,b for the others.
One or more of the organization’s own codes, comma-separated (filter[vendor]=a,b), or filter[vendor][is_not]=a,b for the others.
One or more codes, comma-separated (filter[status]=a,b), or filter[status][is_not]=a,b for the others.
Responses
Section titled "Responses"A page of the list.
object
object
The integration’s public id (int_...).
What it is used for: store (orders come from it), courier (AWBs, labels, tracking), invoicing (invoices), email or sms (messages to customers). New values may appear: treat one you do not know as such.
The vendor’s code: shopify, woocommerce, sameday, fancourier, smartbill, …; test_store, test_courier and test_invoicing are test integrations, connected only in a test organization. A partner’s app installed in the organization is its own vendor: its app id (app_...), as in app_id.
The partner app this integration is, installed in the organization (app_...); null for a Connectato integration.
The name the merchant gave this connection; tells two accounts of one vendor apart.
connected (working); paused (by the merchant, nothing runs); needs_reauth, error, disabled (the merchant must connect it again); disconnected (removed by the merchant, kept so records still name it). New values may appear: treat one you do not know as such.
The vendor-side account it is connected to (a Shopify shop domain, a WooCommerce store URL); null when the vendor has none.
The next page’s cursor; null on the last page.
Example generated
{ "data": [ { "id": "example", "category": "example", "vendor": "example", "app_id": "example", "name": "example", "status": "example", "account": "example", "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z" } ], "next_cursor": "example"}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
No valid access token.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Bearer: send an access token as a Bearer token.
The app was not granted the scope (insufficient_scope).
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Validation failed (validation_failed, errors per field): an unknown filter, value or sort, a limit out of range, a malformed updated_since, or a cursor of another query.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Too many requests: retry after Retry-After seconds.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Seconds to wait before retrying.