Get an integration

GET/v1/integrations/{integrationId}

Returns one integration with its event mapping and configured settings. Settings marked secret by their field definitions are omitted; other returned values may still be sensitive.

Before you call

This endpoint needs IDs that other endpoints return:

1. Call List the account integrations. Copy the id of the integration: it is the integrationId.
2. Call this endpoint with these IDs.

Authentication

bearerAuth: API key created in the dashboard (atk_…). Send it in the Authorization: Bearer YOUR_API_KEY header.

Path parameters

integrationIdstringrequired

ID of the integration. Get it from listIntegrations (id).

Responses

Every response field is present unless it shows optional. A type that ends in | null can be null.

200 Successful response

application/json

dataobject

The integration.

Show 9 child attributes

idstring

ID of the integration. Send it as integrationId to Get an integration and to its logs.

namestring

Name of the integration in AnyTrack.

statusstring

Status of the integration in AnyTrack. Deleted integrations do not appear in the API.

Allowed values added active disabled

providerobject

Platform of the integration, for example a store, a form tool, or an affiliate network.

Show 2 child attributes

idstring

ID of the platform in the AnyTrack integration catalog.

namestring

Name of the platform.

propertyIdstring | null

ID of the property that the integration belongs to. null when the integration belongs to no property.

panelUrlstring | null

Panel URL saved in the integration settings. null when the integration has no panel URL.

liveboolean

true when the integration received events recently.

eventMappingmap of (string | null)

Event mapping of the integration. Each key is an event of the platform. Each value is the AnyTrack event name, or null when the platform event has no AnyTrack event.

customFieldsmap of (string | number)

Configured integration settings whose field definitions are not marked secret. Empty or undefined settings are omitted. Treat returned values as potentially sensitive.

Errors

Every error returns the error object.

Status	Description and action
400	invalid_request, invalid_cursor: A parameter or a body field is not valid, or the cursor belongs to a different query. Correct the request. error.details, when present, names invalid fields. Do not reuse a cursor with a different query.
401	unauthenticated: Missing, invalid or deleted API key. Send a valid key in Authorization: Bearer. MCP uses an OAuth access token, which may also expire or be revoked.
403	api_access_unavailable: API access is disabled for this account. Contact AnyTrack support. OAuth requests also require the anytrack:read scope (insufficient_scope).
404	not_found: An ID does not exist, or it belongs to a different account. The API gives the same error for both. Check the IDs. Get them again from the list endpoints.
429	rate_limited: The account sent more than 60 requests in one minute. Wait for the number of seconds in the Retry-After header, then retry.
500	response_too_large, internal_error: The response is larger than 1 MB, or the API has an internal error. For response_too_large, ask for fewer rows or metrics. For internal_error, contact AnyTrack support with the requestId.
503	service_unavailable: The service is not available for a short time. Retry later, and wait longer after each failed retry.

Request example

Command template. Replace the path placeholders. Add the query parameters that you need. This is not a recorded request or response.

curl --request GET 'https://api.anytrack.io/v1/integrations/{integrationId}' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Download the OpenAPI contract.