Bloss Docs

Import scripts from docs or Markdown

Developers
POST
/brands/{brandId}/scripts/import

Create or update up to 25 scripts at once from Notion pages, Google Docs or Markdown. Each document's code comes from its title ("(3A) …"): a code a script already has updates that script's title, hooks and body and keeps its tag; anything else becomes a new script. Bloss keeps a copy of each document to show with the script. Preview first with dryRun: it reads every document and says what each would become, without saving. Documents that can't be read (private, not found) come back with an error; the rest still import.

Authorization

bearerAuth videos:write
headerAuthorizationBearer <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

Path Parameters

brandId*string

A brand id from GET /me or GET /creator/brands.

Length1 <= length

Query Parameters

dryRun?string

"true": run every check and return { dryRun: true, wouldChange } without changing anything.

Value in"true""false"

Request Body

application/json
  1. body
urls?array<>

Notion pages shared to the web, or Google Docs anyone with the link can view.

Itemsitems <= 25
markdown?string

One or more scripts 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 "---".

Length1 <= length <= 400000
tagName?string

Optional tag for new scripts. Without it, each new script gets a tag named after it.

Length1 <= length <= 60

Response Body

Success.

application/json
  1. response
results*array<>
curl -X POST 'https://example.com/api/v1/brands/string/scripts/import' \  -H 'Content-Type: application/json' \  -d '{}'
{  "results": [    {      "label": "string",      "ok": true,      "action": "created",      "id": "string",      "code": "string",      "warnings": [        "string"      ],      "error": "string"    }  ]}

Was this page helpful?