Create a script
Create one script, as fields (title, hooks, body) or as Markdown in the Bloss script format: a top-level heading with the code in brackets and the title ("# (S5) I paid $40 in late fees"), a "## Hook 1", "## Hook 2"… section per hook with "On screen: …" and "Said: …" lines, and a "## Script" section with what the video says, one line per sentence. Sections like "## Demo direction" are kept for people and not matched. Several scripts can go in one text, separated by a line of "---". The next match scores posts against it. A code another script uses answers 409 conflict: update that script instead. For many scripts, or Notion pages and Google Docs, use POST /brands/{brandId}/scripts/import.
bearerAuth videos:writeAuthorizationBearer <token>Personal access token. Scopes: account:read, creator:read, creator:earnings, managed:read, coach:read, brand:read, creators:read, videos:read, analytics:read, onboarding:read, onboarding:signatures, engagement:read, support:read, integrations:read, payouts:read, funds:read, billing:read, groups:write, videos:write, onboarding:write, sync:write, payouts:write.
Scope: videos:write
brandId*stringA brand id from GET /me or GET /creator/brands.
1 <= lengthdryRun?string"true": run every check and return { dryRun: true, wouldChange } without changing anything.
"true""false"application/json- body
code?stringOptional. Without it, the code in the Markdown title is used, else the next free S.
1 <= length <= 12title?string1 <= length <= 200hooks?array<>items <= 20body?stringlength <= 20000tagName?stringOptional. Without it, a tag named after the script is made.
1 <= length <= 60active?booleanDefault true.
markdown?stringThe whole script as Markdown in the Bloss script format: a top-level heading with the code in brackets and the title ("# (S5) I paid $40 in late fees"), a "## Hook 1", "## Hook 2"… section per hook with "On screen: …" and "Said: …" lines, and a "## Script" section with what the video says, one line per sentence. Sections like "## Demo direction" are kept for people and not matched. Several scripts can go in one text, separated by a line of "---". Fields sent alongside win over what the Markdown says.
1 <= length <= 100000Success.
application/json- response
id*stringcode*stringShort label, unique in the brand (S1, 3A).
title*stringhooks*array<>body*stringWhat the video says after the hook, as Markdown.
active*booleanMatched against new posts. A paused script keeps the posts it has.
tag*|The tag matched sets get.
source*|Where the script came from: a Notion page ("notion"), a Google Doc ("gdoc") or text ("text"). Null when it was written field by field.
posts*integerPosts that follow it.
-9007199254740991 <= value <= 9007199254740991waitingForPick*integerPosts waiting for a person whose best guess is this script.
-9007199254740991 <= value <= 9007199254740991updatedAt*stringwarnings*array<string>What was cut or not found while reading the Markdown.
curl -X POST 'https://example.com/api/v1/brands/string/scripts' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "code": "string", "title": "string", "hooks": [ { "text": "string", "verbal": "string" } ], "body": "string", "active": true, "tag": { "id": "string", "name": "string" }, "source": { "kind": "notion", "url": "string", "readAt": "string" }, "posts": -9007199254740991, "waitingForPick": -9007199254740991, "updatedAt": "string", "warnings": [ "string" ]}Referral payouts GET
Referral bonuses owed or paid to creators whose invite code brought in another creator, newest first, as on the Referral Payouts page.
Delete a script DELETE
Delete a script. Posts it was the answer for lose their script and the next match decides them again. Its tag stays on those posts; delete the tag to remove it.