Quickstart

This is the developer path (REST API + MCP). Just want to share a page without code? Head to Using Shareable → Publish a page.

1. Get an API key

Sign in at useshareable.com, open Developers, and create a key. Copy it — it starts with sm_ and is shown only once.

Treat your key like a password. It can publish, update, and set access on pages in your account.

2. Publish a page

curl -X POST https://useshareable.com/api/v1/pages \
  -H "Authorization: Bearer sm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<!doctype html><h1>Hello from Shareable</h1>",
    "title": "My first page",
    "access": "link"
  }'

const res = await fetch("https://useshareable.com/api/v1/pages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SHAREABLE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    html: "<!doctype html><h1>Hello from Shareable</h1>",
    title: "My first page",
    access: "link",
  }),
})
const { data } = await res.json()
console.log(data.url) // → https://useshareable.com/p/...

The response contains your live URL:

{
  "data": {
    "id": "…",
    "slug": "my-first-page-k3f9d2a8xq4p",
    "url": "https://useshareable.com/p/my-first-page-k3f9d2a8xq4p",
    "access": "link",
    "is_published": true,
    "has_unpublished_changes": false
  }
}

3. Or publish straight from your agent

If you use Claude Code (or any MCP client), skip the API and let your agent do it. See the MCP server guide:

"Publish this dashboard and make it shareable with anyone who has the link."

Next: the publishing & access model

Understand drafts vs. published versions and the three access levels.

Share a PDF or image Authentication

Get started

Using Shareable

How To Guides

Publish from code or agents

API reference

1. Get an API key

2. Publish a page

3. Or publish straight from your agent

Next: the publishing & access model

​1. Get an API key

​2. Publish a page

​3. Or publish straight from your agent

Next: the publishing & access model

1. Get an API key

2. Publish a page

3. Or publish straight from your agent