Campaign Creator Webhooks

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

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

Overview

When a brand has a Webhook URL configured, Growi will send an HTTP POST request with a JSON body whenever a campaign’s creator affiliation changes state, or when a creator’s affiliate code is updated.

Configuration

In the Organization settings, configure:

• Webhook URL: A single HTTPS URL that will receive webhook POST requests.

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

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	10 seconds
Success Criteria	Any 2xx response
Retries	Up to 3 retries on failure

Non-2xx responses are treated as failures and will be retried.

Payload Format

The request body is a single JSON object with the following fields:

event · string · required

Event name that indicates what happened.

occurred_at · string · required

ISO-8601 timestamp of the underlying record update.

campaign_affiliate_id · integer · required

Internal ID of the campaign-creator association record.

campaign_id · integer · required

Campaign ID.

organization_id · integer · required

Organization ID.

user_id · integer · required

Creator’s user ID.

status · string · required

The raw status value on the record (e.g., active, removed, left).

campaign_name · string

Campaign name, when available.

organization_slug · string

Brand slug, when available.

user_email · string

Creator email, when available.

user_name · string

Creator name, when available.

tag · string

Default affiliate tag for the creator on this campaign, when available. For code_updated, this is the new code.

previous_tag · string

Present on campaign_affiliate.code_updated only. The affiliate code before the change.

Optional fields are omitted when values are not present. For status events, occurred_at uses the campaign affiliation record’s updated_at timestamp. For code_updated, it is the time the code change was committed.

Example Payloads

Creator Added to Campaign

{
  "event": "campaign_affiliate.activated",
  "occurred_at": "2026-02-27T18:33:12-05:00",
  "campaign_affiliate_id": 123,
  "campaign_id": 456,
  "organization_id": 789,
  "user_id": 42,
  "status": "active",
  "campaign_name": "Spring Promo",
  "organization_slug": "acme",
  "user_email": "[e-mail]",
  "user_name": "Creator Name",
  "tag": "creator-default-tag"
}

Creator Removed from Campaign

{
  "event": "campaign_affiliate.removed",
  "occurred_at": "2026-02-27T18:35:02-05:00",
  "campaign_affiliate_id": 123,
  "campaign_id": 456,
  "organization_id": 789,
  "user_id": 42,
  "status": "removed"
}

Creator Affiliate Code Updated

{
  "event": "campaign_affiliate.code_updated",
  "occurred_at": "2026-07-14T16:10:00-04:00",
  "campaign_affiliate_id": 123,
  "campaign_id": 456,
  "organization_id": 789,
  "user_id": 42,
  "status": "active",
  "campaign_name": "Spring Promo",
  "organization_slug": "acme",
  "user_email": "[e-mail]",
  "user_name": "Creator Name",
  "previous_tag": "old-code",
  "tag": "new-code"
}

Troubleshooting

Webhook Not Being Received

Ensure your webhook URL is correctly configured in Organization settings and is publicly accessible over HTTPS.

Receiving Duplicate Events

Implement idempotency in your webhook handler using the campaign_affiliate_id, event, and occurred_at fields to deduplicate events.

Webhook Failing with Timeout

Your endpoint must respond within 10 seconds. Consider processing webhooks asynchronously and returning a 200 response immediately.

Got removed when changing a code

Changing a creator’s affiliate code does not remove them from the campaign. Status webhooks (activated / removed / left) only fire on status changes. Code changes emit campaign_affiliate.code_updated instead. If you received a removed event around a code change, check whether the creator was also removed (or a delayed status webhook from an earlier action was delivered).