Creators

Assign creators to campaign

Assign one or more creators to a campaign. Enforces single active campaign per creator.

post/creators/campaigns/assign

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/creators/campaigns/assign
  • Auth: API key in header x-api-key

Request body

creatorIdsstring[] required
campaignIdstring required
startBasis'prev' | 'current' | 'next' | 'custom' | 'today' required
startDatestring date
customRatesPreviewHashstring

The previewHash the custom-rates dry-run (mode merge) returned. When present, custom rates that differ are refused (CUSTOM_RATES_PREVIEW_MISMATCH).

Example request

{
  "customRates": {
    "videoTarget": 15,
    "videoTargetPlatforms": {
      "tiktok": 20
    },
    "values": [
      {
        "id": "rule_A1b2C3d4E5f6",
        "value": 12
      }
    ]
  }
}

Response

OK

updatedinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.