Create the creator's link-in-bio page
POST
/link-in-bioCreates the creator subject's single link-in-bio page. This endpoint supports page copy, social profile links, and link, title, or text blocks. It does not upload remote media, configure custom domains, delete blocks, or expose the full visual designer. Every new block requires a stable client_id so retries cannot create duplicates.
Authorization
ApiKey AuthorizationBearer <token>
Public API key from creator or agency settings. The complete secret is shown once.
In: header
Header Parameters
Idempotency-Key*string
Unique value up to 128 characters. Matching requests are replayed for 24 hours.
Length
1 <= length <= 128Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/link-in-bio" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "slug": "maria-links", "username": "Maria", "bio": "Fashion creator and stylist", "social_links": [ { "platform": "instagram", "handle_or_url": "@maria" } ], "blocks": [ { "client_id": "portfolio", "type": "link", "title": "My portfolio", "url": "https://maria.example.com", "visible": true, "order": 0 } ] }'{ "meta": {}, "request_id": "string", "data": { "id": "string", "creator_id": "string", "slug": "string", "username": "string", "location": "string", "bio": "string", "section_title": "string", "text_block": "string", "avatar_url": "http://example.com", "theme": "classic", "shape": "rounded", "social_links": [ { "platform": "string", "url": "http://example.com" } ], "blocks": [ { "id": "string", "client_id": "string", "type": "link", "title": "string", "url": "http://example.com", "body": "string", "button_text": "string", "visible": true, "order": 0, "style": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "editor_url": "http://example.com", "share_url": "http://example.com", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }}