Help / API keys and the Claude connector
API keys and the Claude connector
Make API keys, choose what each one can do, and connect Claude to your links.
An API key lets other tools use your workspace. You can use a key with the Linkliftr API, with tools like Zapier, or with Claude. Each key only sees the workspace it was made in.
Making a key
- Sign in and open the API and Claude page. Only owners and admins can see it.
- Under New key, give the key a name, for example "Claude" or "Zapier".
- Choose a role, the permissions and when the key expires. These are explained below.
- Press Make key. Copy the key straight away, because it is shown only once.
Keys start with ldk_. The list of keys shows the first few characters of each one, so you can tell them apart, and when each was last used.
How many keys you can have depends on your plan: 1 on Free, 5 on Starter, 20 on Pro and 100 on Agency. Revoked and expired keys do not count.
Roles and permissions
Every key has a role:
- Viewer can read links, tags, bio pages and click statistics.
- Editor can also create and change links and bio pages, and report conversions. This is the default.
- Admin can also manage Zapier and Make hooks, read the audit log and download the workspace's data.
A key can do everything its role allows. If you want it to do less, choose "Only these" and tick the permissions you want. A permission the role does not allow is left out. The permissions are:
- links:read: read links, tags and bio pages
- links:write: create, change and delete links, and import CSV files
- stats:read: read click statistics and conversions
- bio:write: create and change bio pages
- conversions:write: report conversions
- hooks:write: manage Zapier and Make hooks
- audit:read: read the audit log
- export:read: download all workspace data
Give each key only what it needs. A key for a reporting tool, for example, only needs links:read and stats:read.
When a key expires
- A key can expire after 30, 90 or 365 days, or never. 90 days is chosen for you.
- We email the person who made the key 7 days before it expires.
- An expired key stops working. Make a new key and swap it in wherever the old one was used.
Connecting Claude
Claude can work with your links through a connector. The connector address is this address with your key on the end:
https://app.linkliftr.com/mcp/<your key>
- Make a key. Once it is made, press "Copy Claude connector address". This copies the full address with your key in it.
- In Claude, open Settings, then Connectors, and choose Add custom connector.
- Paste the address. Leave authentication empty.
Changes Claude makes show in your audit log and in each link's history as made by Claude, with the name of the key.
What Claude can do
Claude only sees the tools that its key's permissions allow. With an admin key, Claude can:
- Create short links, and change them. This includes UTM values, tags, routing, A/B tests, folders, campaigns and start and end times.
- Look up a link with its click statistics.
- Search your links by text, tag, folder or campaign.
- List your tags, folders and campaigns, and make new folders.
- Create, change and list link-in-bio pages.
- Give a summary of clicks today and in the last 7 days, with your top links and any broken links.
- Compare clicks over a number of days with the same number of days before.
- Show conversions over a number of days.
- Show who created or changed links, and when. This needs an admin key.
Claude cannot delete links or see other workspaces. Paid features still need the right plan. If your plan does not include one, Claude is told so.
Keep your key secret
We only store a scrambled copy of each key, so we cannot show it to you again. If you lose a key, revoke it and make a new one.
Revoking a key
On the API and Claude page, press Revoke next to the key. Anything using it, including Claude, stops working straight away. A revoked key cannot be turned back on.
Using the API
To use the API from your own code, send the key in the header Authorization: Bearer <your key>. Each workspace can make up to 600 requests a minute, and this includes requests from Claude. The API docs list every request you can make.