Get an integration
const url = 'https://api.connectato.com/v1/integrations/example';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/example \ --header 'Authorization: Bearer <token>'Scope: read_integrations.
A disconnected one too, so the integration another record names always resolves.
Authorizations
Section titled "Authorizations"Parameters
Section titled "Parameters"Path Parameters
Section titled "Path Parameters"The public id (int_...).
Responses
Section titled "Responses"IntegrationResource
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.
Example generated
{ "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"}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.
No such resource in the organization (not_found).
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.