campaign.budget.high_upsell

wbhk

Provides budget-increase recommendations for campaigns with high budget
utilization. A delivery can batch campaigns from up to 20 ad accounts.

Payload

A signed campaign.budget.high_upsell webhook delivery.

string

required

^[A-Za-z][A-Za-z0-9]{15}$

A 16-character Base62 delivery identifier. It remains unchanged across automatic retries and manual resends.

event

const

enum

required

Event type for this delivery.

Allowed:

test

boolean

required

Whether the delivery was initiated as a test.

event_at

date-time

required

Time at which MCM created the webhook event, in RFC 3339 format.

platform_id

string

required

length ≥ 1

MCM platform that owns the webhook endpoint.

data

object

required

Budget recommendations grouped by ad account.

Headers

x-moloco-webhook-signature

string

required

^t=[0-9]+,v1=[0-9a-f]{64}(,v1=[0-9a-f]{64})*$

Versioned HMAC signature for the raw request body. The value has the
form t=<unix>,v1=<hex signature>. During signing-key rotation, more
than one v1 value can be present.

Compute HMAC-SHA256(signing_secret, "{t}.{raw_request_body}") and
compare its lowercase hexadecimal digest with a v1 value. Do not
parse or re-serialize the body before verification.

x-moloco-webhook-id

string

required

^[A-Za-z][A-Za-z0-9]{15}$

Idempotency key for the delivery. This value is identical to the body
id. Store processed IDs and ignore duplicate deliveries.

User-Agent

const

enum

required

Identifies webhook requests sent by MCM.

Allowed:

Responses

2XX

Return any 2xx status to acknowledge the delivery.

default

A non-2xx response is treated as a failed attempt and may be retried.