campaigns:write. IDs must belong to the API key’s agency. Completed campaigns return 409 with code: "CAMPAIGN_COMPLETED"; reopen the campaign before editing. Deleted or retired media cannot be edited, except a soft-deleted row can be restored explicitly.
Refresh an account or post
POST /sdk/v1/campaign-media/:campaignCreatorMediaId/refresh
Use the campaignCreatorMediaId returned by the campaign media API.
An account refresh checks for new posts within its existing tracking settings;
a post refresh updates that post’s metrics. Send an empty JSON object or omit
the body. This operation keeps the account’s original tracking start date.
200 response confirms the scrape was queued; execution is asynchronous.
For standalone tracked content, use tracked-media scrape-now.
Campaign media IDs cannot be used with that standalone endpoint.
Freeze and unfreeze performance
POST /sdk/v1/campaign-media/:campaignCreatorMediaId/freeze-performance
pausedAt uses the current time. This opens a performance-pause window for CPM and performance bonuses. Tracking continues. Fixed-rate eligibility is controlled by payment exclusions.
POST /sdk/v1/campaign-media/:campaignCreatorMediaId/unfreeze-performance
unpausedAt to resume at the current time. This closes the pause window; it does not erase its history. The same platform validation and grouped-media rules apply.
To make a warm-up post ineligible for both fixed and performance payments, use both payment-exclusion operations. Setting a score to zero is not a substitute for payment eligibility.
Restore deleted media
POST /sdk/v1/campaign-media/:campaignCreatorMediaId/restore with {} restores a soft-deleted row using its original ID and history. Restoring an account also restores its eligible discovered posts under the platform’s restore rules. Media limits still apply. Tracking-retired rows cannot be restored through this operation.
Restart account tracking
POST /sdk/v1/campaign-media/:campaignCreatorMediaId/restart-tracking
Change account tracking settings
PATCH /sdk/v1/campaign-media/:campaignCreatorMediaId/tracking-settings
trackForUnit is DAYS or MONTHS; trackForValue is a positive integer. The platform applies the settings to the account and eligible child posts while preserving protected history.
Enter manual analytics
PUT /sdk/v1/campaign-media/:campaignCreatorMediaId/manual-analytics
0 through 9007199254740991 (JavaScript’s maximum safe integer); larger values return 400. Counts above the 32-bit integer limit are supported. Use a post ID, not an account. The operation writes a manual snapshot, recalculates affected summaries, and uses the existing platform rules for omitted metrics. Review the resulting analytics before sending a payout.
Successful writes return { "success": true, "data": ... } with the operation’s result and, where applicable, a message. These operations do not send a payout.