Skip to main content

Create Bundle

  • Method: POST
  • URL: https://api.tokportal.com/bundles-create
  • Auth: X-API-Key

This endpoint creates account_only or account_and_videos bundles. For videos_only, use the dedicated endpoint in 14-bundles-create-videos-only.md.

Request body (example):

{
  "title": "API Demo",
  "country": "FR",
  "bundle_type": "account_and_videos",
  "videos_quantity": 5,
  "external_ref": "ext-123",
  "wants_editing": false,
  "edits_quantity": 0,
  "wants_moderation": false,
  "moderation_notice": null,
  "wants_niche_warming": false,
  "niche_warming_instructions": null,
  "auto_finalize_videos": false
}

Response:

{ "bundle_id": "<uuid>" }

Notes:

  • Use platform country codes: USA, UK, FR, CA, IT, PH. The available set may evolve; refer to your dashboard (Bundles → Create) for the authoritative list.
  • account_only requires videos_quantity = 0 and creates no video slots.
  • account_and_videos requires videos_quantity to be one of 5,10,25,50,100,500. N slots are pre-created with status pending and per-video price.
  • Use external_ref for idempotency on your side.
  • Title is optional. If omitted, it defaults to:
    • Account + Videos Bundle when bundle_type = account_and_videos
    • Account Only Bundle when bundle_type = account_only