> ## Documentation Index
> Fetch the complete documentation index at: https://snapto.link/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create a token, make your first API call, and connect an agent.

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

<Steps>
  <Step title="Open the API settings">
    In the dashboard, go to **Settings** then **API**.
  </Step>

  <Step title="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](/authentication) for what each ability unlocks.
  </Step>

  <Step title="Copy the token">
    The token is shown once. Store it somewhere safe. If you lose it, revoke it and create another.
  </Step>
</Steps>

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

## Make your first call

List your profiles:

```bash theme={null}
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:

```bash theme={null}
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, point an MCP client at the hosted server. The same token works.

```bash theme={null}
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.

<Card title="MCP server setup" icon="bot" href="/mcp/overview">
  Setup for Claude Code, Claude Desktop, Cursor, and ChatGPT.
</Card>

## Get help

Something not working? Email [support@snapto.link](mailto:support@snapto.link).