Get a webhook

GET/v1/properties/{propertyId}/webhooks/{webhookId}

Returns one outgoing webhook with its events and its status.

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 webhooks of a property. Copy the id of the webhook: it is the webhookId.
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).

webhookIdstringrequired

ID of the webhook. Get it from listWebhooks (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 webhook.

Show 8 child attributes

idstring

ID of the webhook. Send it as webhookId to Get a webhook.

namestring

Name of the webhook.

urlOriginstring | null

Scheme and host of the webhook URL, for example https://example.com. The API does not return the path or the query string, because they can contain secrets. null when the saved URL has no valid HTTP(S) origin.

eventNamesarray of string

AnyTrack events that the webhook sends.

versioninteger

Payload version of the webhook.

Min -9007199254740991Max 9007199254740991

enabledboolean

false when a user turned off the webhook.

healthyboolean

false when AnyTrack marks the webhook as unhealthy.

crossDomainPropertyIdstring | null

ID of the cross-domain property that filters the events of this webhook. null when the webhook has no cross-domain filter.

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}/webhooks/{webhookId}' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Download the OpenAPI contract.