Add a creator by handle
Adds a creator discovered by social handle and queues its enrichment. Body: platform (e.g. instagram or youtube) and handle (normalised: a leading @ and casing are ignored), plus optional displayName and reenrich (true to re-run enrichment for an already-known creator). Returns { creatorId, created } where creatorId is the public cre_… id and created is whether this call minted the creator (false if the handle already resolved to one). Idempotent per handle. 400 if the input is invalid, 403 if you are not allowed to add creators in the resolved workspace.
A Supabase-issued OAuth user access token. On collection endpoints, pair with a Passo-Workspace header to pick a workspace.
In: header
Header Parameters
The workspace's public id (e.g. wsp_abc) to operate in. OAuth callers with more than one workspace must send it; a single-workspace caller may omit it. Ignored for API keys (the key is pinned to its workspace). A uuid or another resource's id is rejected with a 400.
^wsp_Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/creators" \ -H "Content-Type: application/json" \ -d '{ "platform": "instagram", "handle": "string" }'{ "creatorId": "string", "created": true}