Bloss Docs

Approve a submission: the creator joins the brand

Developers
POST
/brands/{brandId}/onboarding/submissions/{submissionId}/approve

Approve a submission that's awaiting approval (in a flow with completion mode "approval"). This admits the creator: they join the brand as a creator, go into the flow's join group (or the link's default group), get their social accounts from the form tracked, and are emailed. Refused with 409 conflict when it isn't awaiting approval, when its link is full (raise the link's maxUses, then approve again), or when the creator hasn't verified their email yet. Approving again after a partial failure finishes the job.

Authorization

bearerAuth onboarding: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: onboarding:write

Path Parameters

brandId*string

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

Length1 <= length
submissionId*string

An id from GET /brands/{brandId}/onboarding/submissions.

Length1 <= length

Response Body

Success.

application/json
  1. response
outcome*string

"joined": the creator is in the brand now; "already_member": they already were, so the submission was closed.

curl -X POST 'https://example.com/api/v1/brands/string/onboarding/submissions/string/approve'
{  "outcome": "string"}

Was this page helpful?