Get an ad platform connection

GET/v1/properties/{propertyId}/connections/{connectionId}

Returns one ad platform connection with its account, setup status, last sync time, and the destinations that use it.

Before you call

This endpoint needs IDs that other endpoints return:

1. Call List the account properties. Copy the id of the property: it is the propertyId.
2. Call List the ad platform connections of a property. Copy the id of the connection: it is the connectionId.
3. 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

propertyIdstringrequired

ID of the property. Get it from listProperties (id).

connectionIdstringrequired

ID of the ad platform connection. Get it from listConnections (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 ad platform connection.

Show 10 child attributes

idstring

ID of the connection. Send it as connectionId to Get an ad platform connection.

platformstring

Ad platform of the connection.

accountobject

Ad platform account that the connection gives access to.

Show 7 child attributes

idstring

ID of the account on the ad platform.

namestring

Name of the account on the ad platform.

kindstring

Type of the account resource, as the ad platform names it.

currencystring | null

Currency of the account on the ad platform.

timezonestring | null

Time zone of the account on the ad platform.

statusstring | null

Status of the account, as the ad platform gives it.

parentobject | null

Parent of the account on the ad platform. null when the account has no parent.

Show 2 child attributes

idstring

ID of the parent on the ad platform.

namestring | null

Name of the parent.

setupobject

Setup state of the connection.

Show 2 child attributes

statusstring

provisioning: AnyTrack is setting up the connection. ready: the setup is complete. error: the setup failed. Read errorCode.

Allowed values provisioning ready error

errorCodestring | null

Error code of the setup. null when the setup has no error.

authorizedAtstring | null

Time when a user authorized the connection, in ISO 8601 format and in UTC.

authorizedBystring | null

Name of the user who authorized the connection.

lastSyncedAtstring | null

Time of the last sync of spend and campaign data from the ad platform, in ISO 8601 format and in UTC. null before the first sync.

destinationIdsarray of string

IDs of the destinations that use this connection. Send one as destinationId to Get a pixel or ad destination.

createdAtstring

Creation time of the connection, in ISO 8601 format and in UTC.

updatedAtstring

Time of the last change to the connection, in ISO 8601 format and in UTC.

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/properties/{propertyId}/connections/{connectionId}' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Download the OpenAPI contract.