Skip to main content

Refresh Goal Suggestions

POST 

/api/advertising/goal-suggestions/refresh

Starts the goal advisor now instead of waiting for the nightly run. Runs asynchronously as a tracked background job and returns its tracked_job_log_id for progress polling. The advisor first ends Launch goals whose launch window is over, then assesses every product advertised in the given ad accounts (or every selected ad account when ad_account_ids is omitted or empty) and writes new suggestions; when the goal mode is auto, suggestions are applied straight away. Suggestions a person dismissed recently are not repeated.

Required scope: advertising:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Requires the advertising.manage permission; the tenant must have the advertising-manager feature enabled.

Body fields:

  • ad_account_ids (optional, array of up to 500 distinct existing ad account IDs).

Request​

Responses​

OK

Response Headers
    Content-Type