Quickstart - Snapto Docs

This takes you from nothing to a working call against your own profile.

Prerequisites

A Snapto account with an active Lite plan or above. The 7 day free trial counts.
At least one profile. Create one in the dashboard if you have not yet.

Create a token

Open the API settings

In the dashboard, go to Settings then API.

Name the token and pick its abilities

Grant only what the integration needs. To read your links and analytics, profiles:read, elements:read, and analytics:read are enough.See Authentication for what each ability unlocks.

Copy the token

The token is shown once. Store it somewhere safe. If you lose it, revoke it and create another.

A token acts as you. Never commit one to source control or paste it into a public issue.

Make your first call

List your profiles:

curl https://snapto.link/api/v1/profiles \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

You get back your profiles, each with an id you can use in the other endpoints. Now add a link to one of them. Swap in a profile id from the previous response:

curl -X POST https://snapto.link/api/v1/elements \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "PROFILE_UUID",
    "type": "link",
    "name": "My new video",
    "content": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "enabled_for_display": true,
    "enabled_for_download": false
  }'

Load your public page and the link is there. Creating an element needs a token with elements:write.

Connect an agent instead

If you would rather talk to your page than write requests against it, connect an MCP client. The quickest path: in the dashboard, go to Settings then Agents, pick your client, and click Connect. You get the exact command or URL to paste, shown once. In Claude Code, you can also install the official plugin, which bundles the connection plus a skill that makes Claude a careful page manager:

claude plugin marketplace add snaptolink/snapto-claude-plugin
claude plugin install snapto-profile-manager@snapto-plugins

Or point any MCP client at the hosted server directly. The same token from above works:

claude mcp add --transport http snapto https://snapto.link/mcp/YOUR_TOKEN

Then ask it to add a link, reorder your page, or tell you which link got the most clicks this week.

MCP server setup

Setup for Claude Code, Claude Desktop, Cursor, and ChatGPT.

Get help

Something not working? Email support@snapto.link.

​Prerequisites

​Create a token

​Make your first call

​Connect an agent instead

MCP server setup

​Get help

Prerequisites

Create a token

Make your first call

Connect an agent instead

Get help