liinks

List profiles

List the Liinks profiles this API key can manage. Always includes the key owner's own profile; agency owners also see their managed profiles. Call this first to get valid profile ids.

Get profile bundle

Read everything about one profile in a single call: profile fields, theme styles, social links, all blocks (in display order), and the page list. Read this before making edits so updates start from current state.

Update profile fields

Partially update a profile's fields (displayName, bio, tagline, slug, profile picture, …). Only the fields provided change; pass null to clear a clearable field. Note: changing `slug` changes the public URL immediately.

Update styles

Partially update the profile theme: colors, fonts, background, header layout, spacing. Nested objects (background, fontStyle1/2) must be provided whole. When setting explicit button colors, also send tactileLinkType: "NONE" — other tactile styles derive button surfaces from the page color and ignore explicit button colors.

Set social links

Replace the profile's social-icon row with the provided ordered list. This is a full replace: omit an entry to remove it, reorder the array to reorder the row. Read current socials via get_profile first, then send the complete new list. Usernames are accepted and normalized to full URLs.

Add a block

Add a block to a profile page. Supported types: link, text (Markdown), divider, folder, media (YouTube/Vimeo/Spotify embeds). New blocks land at the top of the page by default; use position: "bottom" to append, or after: "<blockId>" to insert beneath an existing block. For folders: create the folder first, then add child blocks with folderId set.

Update a block

Partially update an existing block. Common patterns: { "hidden": true } to hide without deleting, { "hidden": false } to show, { "pageId": "<id>" } to move between pages, { "folderId": "<id>" } to move into a folder (null to remove from one). The block type itself cannot change.

Remove a block

Delete a block from the profile. This cannot be undone via the API — to temporarily hide a block instead, use update_block with { "hidden": true }.

Reorder blocks

Set the top-to-bottom order of blocks on one page. orderedIds must contain EXACTLY the ids currently on that page — no extras, none missing. Read the current set with get_profile first. For single insertions prefer add_block with position/after.

List form submissions

Read visitor responses to forms on the profile, newest first. For polling, pass `since` (ISO 8601) with the highest createdAt seen so far and dedupe by id.

List subscribers

Read the profile's email subscribers, newest first. For polling, pass `since` (ISO 8601) with the highest createdAt seen so far and dedupe by id.

Screenshot the profile

Render the live public profile in headless Chrome and return JPEG URLs covering the full page in viewport-sized chunks (top to bottom). Use after any visual change to verify the result. Defaults to a 375×812 mobile viewport; pass 1280×800 for the desktop layout.