Run a campaign

This page takes one CPM campaign from draft to approved submissions. Paying is covered in Pay creators.

#Create the campaign

POST /v1/creator-campaigns with a profileId, a name, a brandName and economics. Send an Idempotency-Key so a retry does not create two campaigns.

curl -X POST https://api.pozy.ai/v1/creator-campaigns \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Idempotency-Key: launch-clips-2026-11" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "6650c1f0a2b3c4d5e6f70812",
    "name": "Launch clips",
    "brandName": "Acme",
    "platforms": ["tiktok", "instagram", "youtube"],
    "economics": { "type": "cpm", "ratePer1kCents": 100, "minViewsToEarn": 1000, "maxPayoutPerClipCents": 50000, "budgetCents": 500000 },
    "contentRules": "Show the product in the first 3 seconds. Tag @acme. No paid boosting.",
    "trackingDays": 30,
    "holdDays": 10,
    "settlement": "treasury"
  }'

const res = await fetch("https://api.pozy.ai/v1/creator-campaigns", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Idempotency-Key": "launch-clips-2026-11",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "6650c1f0a2b3c4d5e6f70812",
    name: "Launch clips",
    brandName: "Acme",
    platforms: ["tiktok", "instagram", "youtube"],
    economics: { type: "cpm", ratePer1kCents: 100, minViewsToEarn: 1000, maxPayoutPerClipCents: 50000, budgetCents: 500000 },
    contentRules: "Show the product in the first 3 seconds. Tag @acme. No paid boosting.",
    settlement: "treasury",
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.campaign.id, data.campaign.status); // "draft"

import os, requests

resp = requests.post(
    "https://api.pozy.ai/v1/creator-campaigns",
    headers={
        "Authorization": f"Bearer {os.environ['POZY_API_KEY']}",
        "Idempotency-Key": "launch-clips-2026-11",
    },
    json={
        "profileId": "6650c1f0a2b3c4d5e6f70812",
        "name": "Launch clips",
        "brandName": "Acme",
        "platforms": ["tiktok", "instagram", "youtube"],
        "economics": {"type": "cpm", "ratePer1kCents": 100, "minViewsToEarn": 1000, "budgetCents": 500000},
        "settlement": "treasury",
    },
    timeout=30,
)
print(resp.json()["campaign"]["id"])

That campaign pays $1 per 1,000 verified views, only once a post passes 1,000 views, at most $500 per post, from a $5,000 budget.

#Activate, pause, close

#Invite creators

Invite one creator by name and email. The response includes their personal inviteUrl.

curl -X POST https://api.pozy.ai/v1/creator-campaigns/6701a2b3c4d5e6f7a8b9c0d1/participants \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "Cleo Martin", "email": "cleo@example.com" }'

Or create one open link with POST /v1/creator-campaigns/{campaignId}/invite-link and post it anywhere. Everyone who joins through it gets their own personal link. campaign_participant.joined fires when someone joins.

Manage participants with .../participants/{participantId}/suspend, /reinstate, /remove and /resend-invite. Each participant record shows their connected accounts, balances (accruing, owed, payable, settling, settled), flags and payout.status.

#The creator portal

Creators work on a page hosted by Pozy, branded with your campaign branding. If you would rather build your own page, the same actions are public endpoints under /public/creator-campaigns/{token}. They need no API key: the token in the creator's link is the credential.

curl -X POST https://api.pozy.ai/public/creator-campaigns/ptok_9fH2kQ/submissions \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.tiktok.com/@cleo/video/7430000000000000000" }'

// No API key: the participant token from the creator's link authorizes the call.
const res = await fetch(`https://api.pozy.ai/public/creator-campaigns/${participantToken}/submissions`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://www.tiktok.com/@cleo/video/7430000000000000000" }),
});
const { submission } = await res.json();
console.log(submission.status, submission.trackingEndsAt);

import requests

resp = requests.post(
    f"https://api.pozy.ai/public/creator-campaigns/{participant_token}/submissions",
    json={"url": "https://www.tiktok.com/@cleo/video/7430000000000000000"},
    timeout=30,
)
print(resp.json()["submission"]["status"])

#Submission rules

• The post must come from an account the creator connected, on a platform the campaign allows.
• It must be published after the campaign started. Earlier posts are refused at submission.
• Any post age is accepted unless you set maxPostAgeMinutes.
• All verified views count, including views from before the creator submitted. minViewsToEarn, maxPayoutPerClipCents and the budget still apply.
• Only views Pozy reads from the platform earn.

#Review submissions

A submission moves through received, tracking, pending_review, then approved or rejected (or expired, withdrawn). It reaches pending_review when a CPM post passes minViewsToEarn, a pool post passes minViewsToQualify, or a per-post submission first accrues. campaign_submission.pending_review fires.

curl "https://api.pozy.ai/v1/creator-campaigns/6701a2b3c4d5e6f7a8b9c0d1/submissions?status=pending_review&sort=viewsEligible" \
  -H "Authorization: Bearer $POZY_API_KEY"

Filter by status, participantId, platform, flag, an authenticity score range (minScore, maxScore) or text (q), and sort by submittedAt, viewsEligible, earnedCents or authenticityScore.

• Approve: POST .../submissions/{submissionId}/approve.
• Reject: POST .../submissions/{submissionId}/reject with a reason (up to 1,000 characters). The creator sees it.
• Reopen: POST .../submissions/{submissionId}/reopen puts a decided submission back up for review.

#Flags

Pozy flags submissions and never rejects them itself. campaign_submission.flagged fires when a new flag appears.

#Corrections and reporting

• POST /v1/creator-campaigns/{campaignId}/adjustments records an amountCents adjustment for one participant with a cause, such as a bonus or a correction.
• GET /v1/creator-campaigns/{campaignId}/ledger lists every money movement on the campaign.
• GET /v1/creator-campaigns/{campaignId}/report returns spend (budgetCents, consumedCents, settledCents), eligible and total views, submission counts, per-participant balances and an authenticity histogram.

#Errors

#Endpoints

#Webhook events