---
title: "Update promoter campaign"
method: PUT
path: "/promoter_campaigns/{id}"
tags: ["Promoter Campaigns"]
---

# Update promoter campaign

`PUT /promoter_campaigns/{id}`

With this endpoint you can update a promoter campaign. 
 <Tip>**HTTP Request** <br/>`PUT https://api.firstpromoter.com/api/v2/company/promoter_campaigns/{id}`</Tip>

## Path parameters

- `id` integer, required

## Headers

- `Account-ID` string, required

## Request body

- object
  - `ref_token` string
  - `state` 'pending' | 'accepted' | 'rejected' | 'blocked' | 'inactive'
  - `coupon` string
  - `display_coupon` string
  - `direct_url` string
  - `rewards_for_promoters` RewardConfig[]
    - `apply_on` 'monthly' | 'yearly' | 'one_time' | 'all' | 'specific', required
    - `product_ids` integer[], required
    - `reward_id` integer, required
  - `rewards_for_referrals` RewardConfig[]
    - `apply_on` 'monthly' | 'yearly' | 'one_time' | 'all' | 'specific', required
    - `product_ids` integer[], required
    - `reward_id` integer, required
  - `promoter_rewards_customized` boolean
  - `referral_rewards_customized` boolean

## Response `200`

Updated promoter campaign

- PromoterCampaign
  - `id` integer — Id of the promoter campaign
  - `campaign_id` integer — Id of the campaign
  - `promoter_id` integer — Id of the promoter
  - `created_at` string, date-time — Date and time when the promoter campaign was created
  - `promoter` Promoter
    - `id` integer — ID of the promoter
    - `status` string — Status of the promoter
    - `cust_id` string
    - `email` string — Email of the promoter
    - `created_at` string, date-time — ISO date of when the promoter was created
    - `temp_password` string, nullable — Temporary password created for the promoter
    - `default_promotion_id` integer
    - `pref` string
    - `default_ref_id` string — Default referral id of the promoter
    - `note` string, nullable — A note/description of promoter
    - `w8_form_url` string, nullable — Url of the w8 form
    - `w9_form_url` string, nullable — Url of the w9 form
    - `parent_promoter_id` integer — Parent promoter id
    - `earnings_balance` object — Earning balance of the promoter
      - `cash` integer
    - `current_balance` object — Current balance of the promoter
      - `cash` integer
    - `paid_balance` object — Paid balance of the promoter
      - `cash` integer
    - `auth_token` string — Authentication token generated when the promoter was created
  - `campaign` Campaign
    - `id` integer — Id of the campaign
    - `name` string — Name of the campaign
    - `color` string, nullable — Color assigned to the campaign

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found

---

[API](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api.md) · [All operations](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firstpromoter/firstpromoter-batch-processes-api/versions/e15f0d026ccf/schema)