> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstpromoter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promoter Accepted

> Fired when a promoter is approved for a campaign.

Your endpoint will receive this event when a promoter's application to a campaign is accepted — either manually by an admin or automatically if `auto_approve_promoters` is enabled on the campaign.

## Payload

<ResponseField name="event" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="number">
      Unique ID of the event.
    </ResponseField>

    <ResponseField name="type" type="string">
      Always `promoter_accepted` for this event.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the event occurred.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="state" type="string">
      Current state of the promoter in the campaign. Will be `accepted`.
    </ResponseField>

    <ResponseField name="campaign" type="object">
      The campaign the promoter was accepted into.

      <Expandable title="properties">
        <ResponseField name="id" type="number">ID of the campaign.</ResponseField>
        <ResponseField name="name" type="string">Name of the campaign.</ResponseField>
        <ResponseField name="landing_url" type="string">The landing page URL for this campaign.</ResponseField>
        <ResponseField name="description" type="string">Campaign description.</ResponseField>
        <ResponseField name="private" type="boolean">Whether the campaign is invite-only.</ResponseField>
        <ResponseField name="color" type="string">Display color of the campaign (hex code).</ResponseField>
        <ResponseField name="default_webhook_url" type="string">The default webhook URL configured on the campaign.</ResponseField>
        <ResponseField name="auto_approve_rewards" type="boolean">Whether rewards are automatically approved.</ResponseField>
        <ResponseField name="auto_approve_promoters" type="boolean">Whether promoters are automatically approved.</ResponseField>
        <ResponseField name="offer" type="object">The active discount offer for referrals in this campaign.</ResponseField>
        <ResponseField name="referral_reward" type="object">The active commission reward for this campaign.</ResponseField>
        <ResponseField name="promotion_reward" type="object">The active non-monetary or milestone reward.</ResponseField>
        <ResponseField name="target_reward" type="object">The active target-based reward, if set.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="promoter" type="object">
      The accepted promoter. See [Promoter Signs Up](/webhooks/promoter-signs-up) for the full promoter object structure.
    </ResponseField>

    <ResponseField name="promotion" type="object">
      The promotion created for the promoter in this campaign. See [Lead Signup](/webhooks/lead-signup) for the full promotion object structure.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<ResponseExample>
  ```json Response theme={null}
  {
    "event": {
      "id": 22733469,
      "type": "promoter_accepted",
      "created_at": "2024-10-03T11:57:31.228Z"
    },
    "data": {
      "state": "accepted",
      "campaign": {
        "id": 13202,
        "name": "Main Campaign",
        "landing_url": "https://www.example.com",
        "description": "",
        "private": false,
        "color": "#42a5f5",
        "default_webhook_url": "https://hooks.example.com/firstpromoter",
        "auto_approve_rewards": true,
        "auto_approve_promoters": false,
        "offer": {
          "id": 67212,
          "name": "5% discount coupon",
          "amount": 5,
          "unit": "discount_per",
          "default_promo_code": "EXAMPLE-5"
        },
        "referral_reward": {
          "id": 128312,
          "amount": 0,
          "type": "per_referral",
          "unit": "cash",
          "name": "20% recurring commission",
          "per_of_sale": 20,
          "default_promo_code": ""
        },
        "promotion_reward": {
          "id": 68347,
          "amount": null,
          "type": "per_promotion",
          "unit": "free_months",
          "name": "Free subscription months",
          "per_of_sale": 0,
          "default_promo_code": null
        },
        "target_reward": null
      },
      "promoter": {
        "id": 9000754,
        "status": "active",
        "cust_id": null,
        "email": "promoter@example.com",
        "created_at": "2024-10-03T11:57:30.943Z",
        "temp_password": "VKD-uS",
        "default_promotion_id": 11027468,
        "pref": "bh4oj6x",
        "default_ref_id": "myrefid",
        "note": null,
        "w8_form_url": null,
        "w9_form_url": null,
        "parent_promoter_id": null,
        "earnings_balance": null,
        "current_balance": null,
        "paid_balance": null,
        "auth_token": "nu9NhM6Hza-kybjZZJivC-FgMtxMrT_o",
        "profile": {
          "id": 9048173,
          "first_name": "Cooper",
          "last_name": "Faulkner",
          "website": "https://www.cooperfaulkner.com",
          "company_name": "Faulkner Media",
          "phone_number": null,
          "address": "",
          "vat_id": "",
          "country": "AU",
          "paypal_email": null,
          "avatar_url": null,
          "description": null,
          "social_accounts": {
            "tiktok": { "url": "" },
            "twitch": { "url": "" },
            "twitter": { "url": "" },
            "youtube": { "url": "" },
            "facebook": { "url": "" },
            "linkedin": { "url": "" },
            "instagram": { "url": "" }
          }
        },
        "promotions": []
      },
      "promotion": {
        "id": 11027468,
        "status": "offer_running",
        "ref_id": "myrefid",
        "promo_code": null,
        "customer_promo_code": null,
        "target_reached_at": null,
        "promoter_id": 9000754,
        "campaign_id": 13202,
        "referral_link": "https://www.example.com?_get=myrefid",
        "current_offer": {
          "id": 67212,
          "name": "5% discount coupon",
          "amount": 5,
          "unit": "discount_per",
          "default_promo_code": "EXAMPLE-5"
        },
        "current_referral_reward": {
          "id": 128312,
          "amount": 0,
          "type": "per_referral",
          "unit": "cash",
          "name": "20% recurring commission",
          "per_of_sale": 20,
          "default_promo_code": ""
        },
        "current_promotion_reward": null,
        "current_target_reward": null,
        "campaign_name": "Main Campaign",
        "hidden": false,
        "visitors_count": 0,
        "leads_count": 0,
        "customers_count": 0,
        "refunds_count": 0,
        "cancellations_count": 0,
        "sales_count": 0,
        "sales_total": 0,
        "refunds_total": 0,
        "active_customers_count": 0
      }
    }
  }
  ```
</ResponseExample>