Campaign Management

Update Cohort Rewards

Update the cohort reward distribution for a campaign. Cohort rewards are automatically created at campaign creation, but you can customize the reward amounts per cohort. cohort_5_reward must equal the campaign's reward_amount, and cohort_1_reward must be ≥ 3.

PATCH/nfthing/campaign/cohort-rewards

Headers

Field	Type	Required	Description
X-API-Key	string	Yes	Your Membrane API key.
Content-Type	string	Yes	Must be application/json.

Request body

Field	Type	Required	Description
post_id	string	Yes	The post_id of the campaign.
cohort_1_reward	number	Yes	Reward for cohort 1 (attention score 0–2). Must be ≥ 3.
cohort_2_reward	number	Yes	Reward for cohort 2 (attention score 2–4).
cohort_3_reward	number	Yes	Reward for cohort 3 (attention score 4–6).
cohort_4_reward	number	Yes	Reward for cohort 4 (attention score 6–8).
cohort_5_reward	number	Yes	Reward for cohort 5 (attention score 8–10). Must equal the campaign's reward_amount.

Example request

PATCH /nfthing/campaign/cohort-rewards

{
  "post_id": "bbfea083-da7f-492f-a29d-9f66848de9e4",
  "cohort_1_reward": 3,
  "cohort_2_reward": 6,
  "cohort_3_reward": 9,
  "cohort_4_reward": 12,
  "cohort_5_reward": 15
}

Example response

200 OK

{
  "success": true,
  "message": "Cohort rewards updated successfully",
  "data": {
    "post_id": "bbfea083-da7f-492f-a29d-9f66848de9e4",
    "title": "Tech Survey 2026",
    "type": "survey",
    "cohort_rewards": {
      "cohort_1_reward": 3,
      "cohort_2_reward": 6,
      "cohort_3_reward": 9,
      "cohort_4_reward": 12,
      "cohort_5_reward": 15
    }
  }
}