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
}