Obtain a user access token with the clips:edit scope for the broadcaster or a user who has permission to create clips on the channel.
Confirm the target channel is currently live, as clips can only be created from active live streams.
Send a POST request to the Create Clip endpoint (/helix/clips) with broadcaster_id as a query parameter; optionally set has_delay=true to add a brief delay before the clip starts.
Include the Authorization (Bearer token) and Client-Id headers on the request.
Parse the id and edit_url from the response; the clip is being processed asynchronously.
Poll the Get Clips endpoint (/helix/clips?id={clip_id}) until the clip's thumbnail_url is populated, indicating the clip is ready for viewing or sharing.
Known gotchas
Clip creation requires a user OAuth token with clips:edit scope — an app access token is not sufficient for this endpoint.
The clip is not immediately available after the POST response; there is a processing delay before the clip URL becomes accessible.
Clips can only be created from channels that are actively broadcasting; attempting to clip an offline channel returns an error.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp