Create Page

Creates a new Link-in-Bio page in the authenticated workspace. The page starts in an unpublished state. Use the Publish endpoint to make it publicly accessible.

POST /v1/bio/pages

bio:write

Parameters

Request body

Parameter	Type	Required	Description
title	string	Yes	Page title displayed at the top of the bio page.
description	string	No	Short description or tagline.
page_data	object	No	JSON object containing the page layout, links, theme, and other configuration.

Tip

The page_data object is flexible and can contain any JSON structure your frontend needs — links, social icons, color themes, profile images, and section ordering.

Request examples

curl

curl -X POST https://xqr.co/api/v1/bio/pages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Acme Inc",
    "description": "Official links and resources",
    "page_data": {
      "theme": "dark",
      "avatar_url": "https://cdn.xqr.co/avatars/acme.png",
      "links": [
        { "label": "Website", "url": "https://acme.com" },
        { "label": "Twitter", "url": "https://twitter.com/acme" },
        { "label": "GitHub", "url": "https://github.com/acme" }
      ]
    }
  }'

TypeScript

const res = await fetch("https://xqr.co/api/v1/bio/pages", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Acme Inc",
    description: "Official links and resources",
    page_data: {
      theme: "dark",
      avatar_url: "https://cdn.xqr.co/avatars/acme.png",
      links: [
        { label: "Website", url: "https://acme.com" },
        { label: "Twitter", url: "https://twitter.com/acme" },
        { label: "GitHub", url: "https://github.com/acme" },
      ],
    },
  }),
});

const { data, meta } = await res.json();

Python

import httpx

res = httpx.post(
    "https://xqr.co/api/v1/bio/pages",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "title": "Acme Inc",
        "description": "Official links and resources",
        "page_data": {
            "theme": "dark",
            "avatar_url": "https://cdn.xqr.co/avatars/acme.png",
            "links": [
                {"label": "Website", "url": "https://acme.com"},
                {"label": "Twitter", "url": "https://twitter.com/acme"},
                {"label": "GitHub", "url": "https://github.com/acme"},
            ],
        },
    },
)

page = res.json()["data"]

Response

201 Created

{
  "data": {
    "id": "bio_abc123",
    "title": "Acme Inc",
    "description": "Official links and resources",
    "slug": "acme-inc",
    "page_data": {
      "theme": "dark",
      "avatar_url": "https://cdn.xqr.co/avatars/acme.png",
      "links": [
        { "label": "Website", "url": "https://acme.com" },
        { "label": "Twitter", "url": "https://twitter.com/acme" },
        { "label": "GitHub", "url": "https://github.com/acme" }
      ]
    },
    "is_published": false,
    "published_at": null,
    "view_count": 0,
    "click_count": 0,
    "html_url": "https://bio.xqr.co/acme-inc",
    "created_at": "2026-03-21T10:00:00Z",
    "updated_at": "2026-03-21T10:00:00Z"
  },
  "meta": {
    "request_id": "req_s1t2u3",
    "rate_limit": {
      "remaining": 48,
      "reset_at": "2026-03-21T12:01:00Z"
    }
  }
}