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.
advertising:writeGrant 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
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.