Skip to main content

Bulk Accept or Dismiss Goal Suggestions

POST 

/api/advertising/goal-suggestions/bulk

Accepts or dismisses up to 1000 goal suggestions in one call. Accepting sets the product's goal to the suggested one (with the suggestion's reason, recorded as set by the advisor); dismissing closes the suggestion, storing the optional reason in its evidence.

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:

  • ids (required, array of 1 to 1000 distinct existing suggestion IDs).
  • action (required): accept or dismiss.
  • reason (optional, string, max 1000): dismissal reason; ignored when accepting.

Suggestions are processed one by one; one that is no longer open, or whose goal is blocked by a guardrail, is reported as failed without stopping the others. Response data has one row per suggestion: id, ok, error. meta.done and meta.failed count the outcomes.

Request​

Responses​

OK

Response Headers
    Content-Type