prepare_tracking Track links on a campaign | Proposes account or post links the person gave as tracking for one creator on one campaign. | campaigns:write + campaigns:read | Adds something that can be undone in Grade. | POST /sdk/v1/campaigns/:id/creators/media |
prepare_tracked_media_add Track links outside a campaign | Proposes account or post links the person gave for the organization’s Tracking, outside any campaign. | analytics:write | Adds something that can be undone in Grade. | POST /sdk/v1/analytics/tracked-media/bulk |
prepare_payment_terms Set up payment terms | Proposes payment terms for one or more creators (up to 20) on one campaign. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | None |
prepare_campaign_complete Complete a campaign | Proposes completing one open campaign, which stops its tracking and pending accrual and makes no new payouts from it until it is reopened. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaigns/:id/complete |
prepare_campaign_reopen Reopen a campaign | Proposes reopening one closed campaign, which resumes its tracking and pending accrual under the creators’ existing terms. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaigns/:id/reopen |
prepare_campaign_update Edit a campaign | Proposes changing one campaign’s title, description, start date, or its end date when it has one. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | PATCH /sdk/v1/campaigns/:id |
prepare_campaign_creators Add creators to a campaign | Proposes creators of the organization to add to one campaign. | campaigns:write + campaigns:read | Adds something that can be undone in Grade. | POST /sdk/v1/campaigns/:id/creators |
prepare_creator_removal Remove creators from a campaign | Proposes creators to remove from one campaign. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | DELETE /sdk/v1/campaigns/:id/creators |
prepare_creator_hide Hide a creator on a campaign | Proposes hiding one creator on one campaign: they stay on it but are left out of payouts due until unhidden. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | PATCH /sdk/v1/campaign-creators/:id/visibility |
prepare_creator_unhide Unhide a creator on a campaign | Proposes unhiding one hidden creator on one campaign, which brings them back into the roster and payouts due. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | PATCH /sdk/v1/campaign-creators/:id/visibility |
prepare_creator_move Move a creator to another campaign | Proposes moving one creator from one campaign to another open campaign, with their tracked accounts and posts, payouts, approvals and payment terms. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-creators/:id/move |
prepare_content_removal Remove a post from a campaign | Proposes removing one post from a creator’s content on one campaign. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | DELETE /sdk/v1/campaigns/:id/creators/media |
prepare_post_restore Restore a removed post | Proposes restoring one removed post to its campaign, where it counts toward the creator’s pay again. | campaigns:write + campaigns:read | Adds something that can be undone in Grade. | POST /sdk/v1/campaign-media/:id/restore |
prepare_post_freeze Freeze a post’s performance | Proposes freezing one live post’s performance on its campaign, so views it earns from now count toward neither CPM nor bonuses. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-media/:id/freeze-performance |
prepare_post_resume Resume a post’s performance | Proposes resuming one frozen post’s performance on its campaign, so views it earns from now count again (those earned while it was frozen stay excluded). | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-media/:id/unfreeze-performance |
prepare_post_exclude_performance Exclude a post from CPM and bonuses | Proposes excluding one live post from CPM and bonuses on its campaign, so its views stop counting toward them. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-media/:id/exclude-performance |
prepare_post_include_performance Include a post in CPM and bonuses | Proposes including one post excluded from CPM and bonuses on its campaign again, so its views count toward them again. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-media/:id/unexclude-performance |
prepare_post_exclude_fixed_rate Exclude a post from the fixed rate | Proposes excluding one live post from fixed pay on its campaign, both per post and upload goals. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-media/:id/exclude-fixed-rate |
prepare_post_include_fixed_rate Include a post in the fixed rate | Proposes including one post excluded from fixed pay on its campaign again, both per post and upload goals. | campaigns:write + campaigns:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-media/:id/unexclude-fixed-rate |
prepare_pay_bonus Set a creator’s pending bonus | Proposes setting one creator’s pending manual bonus on one campaign to the amount the person said, in place of any pending one. | payouts:write + campaigns:read + payouts:read | Changes or removes something that may not be undoable. Read the confirmation with care. | PUT /sdk/v1/campaign-creators/:id/pending-bonus |
prepare_pay_cycle_waive Waive a creator’s pay cycle | Proposes waiving one due pay cycle of one creator’s recurring terms on one campaign, for the reason the person gave, so it stops being owed. | payouts:write + campaigns:read + payouts:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-creators/:id/pay-cycle-windows/waive |
prepare_pay_cycle_restore Restore a waived pay cycle | Proposes restoring one waived pay cycle of one creator on one campaign, so it is owed again. | payouts:write + campaigns:read + payouts:read | Changes or removes something that may not be undoable. Read the confirmation with care. | POST /sdk/v1/campaign-creators/:id/pay-cycle-windows/restore |