Move a creator between campaigns

​

POST /sdk/v1/campaign-creators/:campaignCreatorRecordId/move

​

Path parameter

• campaignCreatorRecordId (required): the campaign creator record to move. Get this value from the v2 campaign creator list or v1 campaign creator list. Use includeHidden=true when listing creators to find a hidden record.

​

Body

• destinationCampaignId (required): a non-empty string identifying an ongoing (ONGOING) campaign in the same agency. Get the campaign ID from List campaigns.

​

Example request

curl -sS "$BASE_URL/sdk/v1/campaign-creators/CCR_123/move" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Application-Id: $APP_ID" \
  -H "X-Api-Key: $API_KEY" \
  -d '{"destinationCampaignId": "camp_summer_launch"}'

​

Response

{
  "success": true,
  "data": {
    "campaignCreatorRecordId": "CCR_123",
    "sourceCampaignId": "camp_spring_launch",
    "destinationCampaignId": "camp_summer_launch",
    "creatorProfileId": "cp_123"
  }
}

​

Move behavior

• The campaignCreatorRecordId and linked media IDs stay the same.
• The creator’s media, contract history, payouts, payout approvals, and associated campaign history follow the membership to the destination. Creators with existing payments can be moved.
• Existing contract terms and visibility are retained. If the campaigns use different effective timezones, future calendar pay-cycle dates are realigned to the destination timezone, as in the platform.
• A completed source campaign is allowed; the destination must be ongoing.
• The source and destination campaign summaries are refreshed after the move.
• The move does not merge memberships. An existing active creator record in the destination returns 409.

​

Common errors

• 400: an ID is missing or invalid, the request includes agencyId, the destination is the current campaign, or the destination is not ongoing
• 401: missing or invalid SDK credentials
• 403: the API key lacks campaigns:write
• 404: the creator record or either campaign is deleted, missing, or unavailable to your agency
• 409: the creator already has an active record in the destination campaign

{
  "success": false,
  "message": "Creator record or destination campaign not found"
}