UGC Distribution at Scale

Brands can use TokPortal to distribute approved creator content through country-specific bundles. TokPortal provides the workflow API; you remain responsible for creator permissions, disclosures, localized copy, and content quality.

Workflow

Collect creator assets and usage rights.
Store media at public/direct URLs or upload through Media Upload.
Create one bundle per market/platform, or use bulk creation per country.
Configure localized captions and publish dates.
Publish and monitor lifecycle events.
Compare analytics once posts are live.

Create a market bundle

curl -X POST https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "US",
    "videos_quantity": 6,
    "title": "UGC Wave 1 - US",
    "wants_niche_warming": true,
    "niche_warming_instructions": "Lifestyle and product review content.",
    "external_ref": "ugc-wave-1-us"
  }'

Reference: Create Bundle

Configure UGC videos

curl -X PUT https://app.tokportal.com/api/ext/bundles/bnd_abc123/videos/batch \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "position": 1,
        "video_type": "video",
        "description": "Creator review: first week with the product #review",
        "target_publish_date": "2026-06-05",
        "video_url": "https://cdn.example.com/ugc/creator-01.mp4",
        "external_ref": "creator-01-us"
      },
      {
        "position": 2,
        "video_type": "video",
        "description": "Unboxing the new drop #unboxing",
        "target_publish_date": "2026-06-07",
        "video_url": "https://cdn.example.com/ugc/creator-02.mp4",
        "external_ref": "creator-02-us"
      }
    ]
  }'

Reference: Configure Videos

Scale across markets

Bulk creation is per country. Loop through target countries:

for country in US UK FR DE; do
  curl -X POST https://app.tokportal.com/api/ext/bundles/bulk \
    -H "X-API-Key: $TOKPORTAL_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"accounts_count\": 2,
      \"upload_accounts_count\": 1,
      \"platforms\": [\"tiktok\", \"instagram\"],
      \"country\": \"$country\",
      \"videos_per_account\": 6,
      \"wants_niche_warming\": true,
      \"niche_warming_instructions\": \"Lifestyle and product review content.\",
      \"external_ref\": \"ugc-wave-1-$country\"
    }"
done

This creates one country-specific batch at a time. Localize captions and publish dates before configuring each bundle.

Reference: Create Bulk

Track performance by market

Use delivered account IDs:

curl -X GET "https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics" \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

Post-level metrics:

curl -X GET "https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics/videos?sort_by=views&sort_order=desc" \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

Reference: Analytics

Practical notes

Use external_ref to map each video to creator, market, and campaign.
Avoid reusing identical captions everywhere; localize language and hashtags.
Spread publish dates using target_publish_date.
Use Webhooks to update your internal content tracker.
Do not use the API copy to imply guaranteed reach or platform safety.