Lnk.Bio Link Pages

Use this as the FIRST call when creating, building, or improving a profile. Returns username, profile URL, and profile picture. If profile_pic is empty or shows the default avatar, set a real one using update_profile_pic. Then call get_style to check the theme, then call list_block_types to pick a layout archetype matching the user (creator, business, local_business, musician, journalist, personal), then call list_blocks to see the current page structure. Follow the archetype's blocks array to build the page. BLOCK_PROFILEPIC must always be first. Add links via add_link.

Use this to upload a profile picture. IMPORTANT: uploading the picture does NOT make it visible. The page must have a BLOCK_PROFILEPIC block for the picture to render. Build the block skeleton first (add_block), then upload the picture. Ask the user for their preferred image, or use their brand logo from their website.

Use this to retrieve all links on the user's Lnk.Bio profile. Check the results for links missing images. For every link without an image, browse its destination URL to find the og:image, logo, or favicon, then call edit_link to attach it.

Use this to add a link to the profile. IMPORTANT: links are stored but will NOT appear unless the page has a BLOCK_LNKS block. Ensure the block skeleton is built first. ALWAYS attempt to source an image before creating the link: browse the destination URL for the site's og:image, logo, or favicon. Links with images receive 2-3x more clicks than text-only links. Only omit the image if the destination site has no usable image at all. Titles should be clean, plain text (e.g. "Start Learning For Free", "Download the App").

Update one or more properties of an existing link. Only included fields are updated; omitted fields are left unchanged. Empty strings clear optional fields like image, group_id, and schedule.

Permanently delete a link from the user's Lnk.Bio profile. This cannot be undone.

Set the position for multiple links at once. Only the specified links are updated; others keep their current position.

Retrieve all link groups on the user's Lnk.Bio profile. Requires a MINI subscription.

List all pages for the authenticated user, including position, visibility status, and remaining page quota.

Use this to create a new page. New pages are EMPTY. After creating, you must add at least BLOCK_PROFILEPIC (for the profile picture and username to appear) and BLOCK_LNKS (for links to appear) using add_block. Title must be at least 5 characters. Custom URLs require a UNIQUE subscription.

Update properties of an existing page. Only included fields are updated. The main page (PAGE_LNKS) cannot have its URL or icon changed, and cannot be hidden. An empty url string clears the custom URL.

Permanently delete a page. The main page (PAGE_LNKS) cannot be deleted. This cannot be undone.

Set the order of all pages. Every page must be included in the request.

Use this to see the current block structure of a page. Call this before adding blocks to avoid duplicates. Check the _hints field in the response for warnings. Correct block order: BLOCK_PROFILEPIC (first, this is the page header), BLOCK_BIO, BLOCK_ICONS, BLOCK_VIDEO, BLOCK_LNKS. Use sort_blocks to fix order if needed.

Use this BEFORE adding any blocks. Returns available block types AND example_layouts with proven archetypes (creator, business, local_business, musician, journalist, personal). Pick the archetype closest to the user, then follow its blocks array as the page structure, its icons list, and its link_titles for clean title inspiration. Check the "recommended" and "warning" fields on each type. Never add BLOCK_TITLE, BLOCK_HEADLINE, or BLOCK_BUTTON.

Use this to add a structural block to the page layout. Blocks control what is rendered: without BLOCK_PROFILEPIC the profile picture is invisible, without BLOCK_LNKS links are invisible. Build the full block skeleton BEFORE populating content. Call list_blocks first to avoid duplicates. Follow the archetype from list_block_types. WARNING: add_block PREPENDS by default. Calling it multiple times without the "after" parameter produces REVERSE visual order. Always call sort_blocks after adding all blocks to set the correct order with BLOCK_PROFILEPIC at position 0.

Delete a block from a page. The block and its data are permanently removed.

Use this after adding all blocks to enforce the correct visual order. Every block currently in the page must be included. BLOCK_PROFILEPIC MUST be at position 0 (first) so the profile picture and name appear at the top. Recommended order: BLOCK_PROFILEPIC, BLOCK_BIO, BLOCK_ICONS, BLOCK_VIDEO, BLOCK_LNKS.

List available forms (id, name, type). Use form IDs when creating a BLOCK_FORM block. Requires UNIQUE subscription.

Use this to find icon type_ids before calling add_icon. Every profile should have social media icons. Common searches: "instagram", "tiktok", "youtube", "twitter", "facebook", "linkedin". IMPORTANT: email, phone, and WhatsApp are also icons (not links). When a user wants to add their email, phone, or WhatsApp, search for them here and add them as icons in a BLOCK_ICONS block, not as links. Minimum 3 characters.

List all icons in a BLOCK_ICONS block. Returns each icon's type, URL, visibility, and position.

Add an icon to a BLOCK_ICONS block. Each icon type can only appear once per block. Instagram and TikTok usernames are automatically formatted to full URLs.

Update the URL of an existing icon in a BLOCK_ICONS block.

Remove an icon from a BLOCK_ICONS block. The block itself is not deleted, only the specified icon.

Rearrange the order of icons within a BLOCK_ICONS block. All icons currently in the block must be included.

Use this after get_profile to check the current style. If no theme is applied (theme_id is 0 or empty), apply one using list_themes + apply_theme to give the profile a polished, professional look.

Update one or more color properties. Only included fields are updated. Pass an empty string to reset a color to default. Requires UNIQUE subscription.

Update one or more font settings. Use list_fonts to find font IDs. Pass an empty string to reset to default. Requires UNIQUE subscription.

Set mobile and/or desktop wallpaper images. Provide a URL to an image (jpg, png, gif, svg). Pass an empty string to remove. Requires UNIQUE subscription.

Apply a free theme to the profile. Use list_themes to find theme IDs. Only free themes can be applied via API. Applying a theme overrides any custom colors, fonts, and wallpapers the user has set.

Remove the active theme and reset all colors, wallpapers, and effects to their default values.

List available font families. Optionally filter by name. Use the font_id when setting fonts via set_fonts.

Use this to find a theme for the profile. Every profile should have a theme applied for a professional look. Filter by name or color to match the user's brand. Use the theme_id with apply_theme.