FirstPromoter icon

FirstPromoter

Interact with the official FirstPromoter APIs

Referral → Move Referrals

AI-generated

Summary

Move specified referrals to a destination promoter campaign by providing the destination promoter campaign ID and the list of referral IDs to move.

Inputs

  • Promoter Campaign ID (required) — The destination promoter campaign ID that pairs a promoter to a campaign (not the campaign ID).
  • Referral IDs (required) — Array of referral IDs to move to the specified promoter campaign. If more than 5 IDs are provided, the move is processed asynchronously with accessible statuses (pending, in_progress, completed, failed, stopped).

Output shape

a JSON array containing the API response to the move request

The response is an array containing the API's JSON output representing the result of the move operation. For asynchronous moves (over 5 referrals), status can be tracked via provided statuses.

Examples

Example 1: Move three referrals to a new promoter campaign

Set 'Promoter Campaign ID' to the destination ID and 'Referral IDs' to the array of referral IDs to be moved.

Links

Discussion