Console API

Ads sync

2 endpoints.

POST/api/v1/admin/businesses/{business_id}/ads/accounts/{ads_account_id}/sync

Sync this ad account from Meta now (entities + insights)

Parameters

Name	In	Type
`business_id`required	path	`string (uuid)`
`ads_account_id`required	path	`string (uuid)`
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_AdAccountData_

Field Type Description

request_idrequired string

success true default true

datarequired

AdAccountData

AdAccountData fields

Field	Type	Description
`id`required	`string (uuid)`
`businessId`required	`string (uuid)`
`externalPlatform`required	`string`
`externalPlatformAccountId`required	`string`
`externalPlatformBusinessId`	`string \| null`
`defaultPageId`	`string \| null`
`currencyCode`required	`string`
`timezoneName`required	`string`
`connectedAt`required	`string (date-time)`
`lastValidatedAt`	`string (date-time) \| null`
`revokedAt`	`string (date-time) \| null`

metadata

ResponseMetadata | null

ResponseMetadata fields

Field Type Description

pagination

PaginationMetadata | null

PaginationMetadata fields

Field	Type	Description
`limit`required	`integer`
`next_cursor`	`string \| null`
`prev_cursor`	`string \| null`
`has_more`required	`boolean`
`has_prev`	`boolean`	default false
`total_count`	`integer \| null`

status_counts

object | null

object | null fields

Map of string to integer

lifecycle_counts

LifecycleCounts | null

LifecycleCounts fields

Field	Type	Description
`lead`	`integer`	default 0
`prospect`	`integer`	default 0
`customer`	`integer`	default 0
`former_customer`	`integer`	default 0

classification_counts

ClassificationCounts | null

ClassificationCounts fields

Field	Type	Description
`signal`	`object`	object fields Nested object (not expanded)
`touch`	`object`	object fields Nested object (not expanded)
`stage`	`object`	object fields Nested object (not expanded)

meta

ResponseMeta | null

ResponseMeta fields

Field	Type	Description
`total`	`integer \| null`
`total_count`	`integer \| null`
`page`	`integer \| null`
`per_page`	`integer \| null`

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/ads/accounts/{ads_account_id}/sync-attempts

List sync attempts for an ad account

Parameters

Name	In	Type	Description
`business_id`required	path	`string (uuid)`
`ads_account_id`required	path	`string (uuid)`
`status`	query	`string \| null`
`cursor`	query	`string \| null`
`limit`	query	`integer`	default 20
`authorization`	header	`string \| null`

Responses

200Successful Response

application/jsonSuccessResponse_list_AdSyncAttemptData__

Field Type Description

request_idrequired string

success true default true

datarequired

AdSyncAttemptData[]

AdSyncAttemptData[] fields

Field	Type	Description
`id`required	`string (uuid)`
`businessId`required	`string (uuid)`
`adsAccountId`required	`string (uuid)`
`campaignId`	`string (uuid) \| null`
`syncType`required	`enum`	one of "full", "entities", "insights", "insights_daily"
`status`required	`enum`	one of "pending", "running", "partial", "failed", "succeeded"
`attemptNumber`required	`integer`
`parentAttemptId`	`string (uuid) \| null`
`startedAt`	`string (date-time) \| null`
`finishedAt`	`string (date-time) \| null`
`error`	`object \| null`
`createdAt`required	`string (date-time)`

metadata

ResponseMetadata | null

ResponseMetadata fields

ResponseMetadata, expanded above.

meta

ResponseMeta | null

ResponseMeta fields

ResponseMeta, expanded above.

400Bad request
401Unauthorized
403Forbidden
404Not found
422Validation error
500Internal server error
503Service unavailable

Error bodies: ErrorResponse. See Errors.