NOIZDocs
DashboardGet started

Tools

add_link

Adds a link at the end of the creator's page, or at the end of one of its groups.

page:writeOnly addsChanges a public page

Shown in apps as Add a link. Offered to an app allowed to change your links, name, bio and location.

Parameters

titlestringrequired

What the button says, up to 100 characters

urlstringrequired

A web address, an email address or a phone number. 1 to 2048 characters.

group_iduuidoptional

A group's id from get_my_page, to add it inside that group

Returns

The new link's id. The link is added at the end of the page, or at the end of the group named.

Changes show on your public page within about a minute. The change is recorded in your account's activity with the app's name.

Example

You ask:

Add a link called Portfolio to example.com.

The app calls:

tools/call · add_link
{
  "name": "add_link",
  "arguments": {
    "title": "Portfolio",
    "url": "example.com"
  }
}

Hints

annotations
{
  "title": "Add a link",
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}