Campaign creator webhooks

Receive notifications when creators are added, removed, have their affiliate code updated, or generate sales on campaigns

Prerequisite You need administrative access to your Growi dashboard to configure webhook URLs.

Overview

When a brand has one or more Webhook URLs configured, Growi will send an HTTP POST request with a JSON body whenever a campaign’s creator affiliation changes state, a creator’s affiliate code is updated, or a creator generates an attributed sale.

Configuration

In the Organization settings, configure:

• Webhook URLs: One or more HTTPS destinations. Every active destination receives every event.

Event types

The webhook payload includes an event field to differentiate between actions:

Event	Description
campaign_affiliate.activated	Creator was added/activated on the campaign
campaign_affiliate.removed	Creator was removed from the campaign
campaign_affiliate.left	Creator left the campaign
campaign_affiliate.code_updated	Creator’s affiliate code (tag) was changed
affiliate_sale.created	A sale was attributed to one of your creators

If the system encounters an unknown status, it will fall back to campaign_affiliate.<status>.

Delivery details

Setting	Value
Method	POST
Content-Type	application/json
Connect Timeout	10 seconds
Read Timeout	30 seconds
Success Criteria	Any 2xx response
Retries	Up to 3 retries on failure

Non-2xx responses are treated as failures and will be retried. Delivery is at-least-once: use the payload’s idempotency_key to deduplicate.