Publish a YouTube Shorts Clip

POST /api/v1/videos/youtube-shorts/{id}/clips/{clipId}/publish

Publish a generated clip to one of the user's connected social accounts. Supported platforms: TikTok, Instagram Reels, Facebook Reels, YouTube Shorts.

pepe.business auto-appends attribution to the original creator at the end of the caption (e.g. "Originally from youtube.com/@creator — full video in bio"). This is required by the Clip Rewards terms and protects you against DMCA claims.

Pass an optional campaignId to enroll the published clip in a Clip Rewards campaign — once enrolled, the clipper earns a payout per 1,000 verified views (subject to the 7-day cooling-off period, see Clip Rewards Claims).

Path parameters

Param	Type	Description
`id`	string	The `vjob_xxx` job identifier
`clipId`	string	The `clip_xxx` clip identifier

Request body

{
  "platform": "tiktok",
  "caption": "When the beat drops... 🎵 #fyp",
  "campaignId": "crw_cmp_xxx"
}

Field	Type	Required	Description
`platform`	string	yes	One of `tiktok`, `instagram`, `facebook`, `youtube`
`caption`	string	no	Override caption. Attribution is auto-appended regardless.
`campaignId`	string	no	Clip Rewards campaign to enroll this published clip in

Response

{
  "id": "pub_xxx",
  "clipId": "clip_xxx",
  "platform": "tiktok",
  "caption": "When the beat drops... 🎵 #fyp\n\nOriginally from youtube.com/@creator — full video in bio",
  "status": "publishing",
  "campaignId": "crw_cmp_xxx",
  "claimId": "crw_clm_xxx",
  "createdAt": "2026-08-11T10:10:00Z"
}

When campaignId is provided, a Claim row is created in pending status and the clip_reward.claimed webhook is fired.

Example

curl -X POST "https://pepe.business/api/v1/videos/youtube-shorts/vjob_xxx/clips/clip_xxx/publish" \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "tiktok",
    "caption": "When the beat drops... 🎵 #fyp",
    "campaignId": "crw_cmp_xxx"
  }'