REreacherapp
Campaigns

Add a creator to another campaign (move)

Changed on

Adds the creator to a target campaign — purely additive (never removes them from the source campaign). The SOURCE shop is your x-shop-id; the TARGET shop + campaign are in the body.

Restrictions:

  • Region — the target shop must be region-compatible with the source shop. GLOBAL and US are interchangeable; every other region must match exactly. Mismatch → 409.
  • Same customer — the target shop must belong to your API key's customer (cross-customer target → opaque 404).
  • No double-add — if the creator is already ACTIVE (or paid/completed) in the target → 409. A passive/terminal-inactive mapping (viewed/pending/invited/applied/removed/rejected/archived/withdrawn) is UPGRADED to active with NO duplicate row (pg_advisory_xact_lock guards it; a paid_at row is never overwritten).

Rewards are recomputed server-side from the TARGET campaign. notify (default true) sends the creator an acceptance-style notification — SKIPPED on X-Dry-Run.

post/campaigns/creators/{creator_id}/add-to-campaign

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/campaigns/creators/{creator_id}/add-to-campaign
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Path parameters

creator_idinteger required

Headers

Idempotency-Keystring nullable
X-Dry-Runstring nullable

Request body

target_campaign_idinteger required

Campaign the creator is being added to (lives in target_shop_id).

target_shop_idinteger required

Shop that owns the target campaign. Must belong to the same customer as your API key (else 404).

notifyboolean

Send the creator an acceptance-style notification on add. SKIPPED on X-Dry-Run.

Response

Added or upgraded to active.

successboolean
codestring
dataobject

{campaign_creator_mapping_id, campaign_id, status='active'}.

Changes

  • 291230805105Revision changes
    • info

      api operation id add_creator_to_campaign_campaigns_creators__creator_id__add_to_campaign_post removed and replaced with campaign_creator_add