Ad Campaigns

List ads that need attention

Changed on

Lists what needs attention across your ads, most severe first:

  • ads created in the last 90 days that were rejected
  • campaigns the platform reports delivery issues on
  • Meta ad accounts with a failed or overdue payment, or disabled while holding live ads
  • campaigns that spent on 3 or more of the last 7 days without a result (conversion, lead, purchase or conversation goals)
  • budgets spent to their daily cap yesterday
  • ads connections that need reconnecting while they still hold live ads
  • ad accounts whose sync has been failing

Built from stored data and the last 7 days of synced metrics, so it costs no platform call.

Each alert has a stable id. Dismiss one with POST /v1/ads/alerts/{alertId}/dismiss to hide it for 30 days.

get/v1/ads/alerts

Request

  • Base URL
    https://zernio.com/api
  • URL
    https://zernio.com/api/v1/ads/alerts
  • Auth
    HTTP bearer

Query parameters

accountIdstring

Only alerts of this ads connection (sibling-expanded like /v1/ads/tree). Omit for every ad account the API key can reach.

profileIdstring

Only alerts of the ads connections on this profile. Omit for every profile the API key can reach.

includeDismissedboolean

Also return dismissed alerts, with dismissed: true.

Response

Alerts, most severe first.

Changes

    • breaking

      the /// response's property format changed from uri to uri-reference for status

    • warning

      added the new connection_lost enum value to the // response property for the response status

    • warning

      added the new sync_failing enum value to the // response property for the response status

    • info

      added the new optional query request parameter profileId

    • info

      added the optional property // to the response with the status

    • info

      endpoint added