Quickstart

Get from zero to your first uploaded page in under 2 minutes.

Create a free account at sharedrop.cloud. Sign in with Google or GitHub.

2. Create an API Key

Go to Dashboard > Settings > API Keys
Click Create API Key
Copy the key (starts with sd_) -- it is only shown once

3. Upload HTML

Use curl to upload your first page:

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: text/html" \
  -d "<html><body><h1>Hello from sharedrop</h1></body></html>" \
  "https://sharedrop.cloud/api/v1/pages?title=My+First+Page"

Response:

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "abc123",
    "title": "My First Page",
    "mode": "static",
    "file_size": 52,
    "visibility": "public",
    "url": "/username/abc123",
    "full_url": "https://sharedrop.cloud/username/abc123",
    "created_at": "2026-04-07T00:00:00.000Z",
    "updated_at": "2026-04-07T00:00:00.000Z"
  }
}

4. Open Your Page

Click the full_url from the response to view your page. Share the link with anyone.

Alternative: Upload via CLI

Install the CLI and upload in one command:

npx @sharedrop/cli upload index.html --title "My Report"

Or pipe HTML from stdin:

echo "<h1>Hello</h1>" | npx @sharedrop/cli upload - --title "Quick Paste"

Alternative: Upload via MCP

If your AI agent supports MCP, connect it to sharedrop's remote MCP endpoint and use the paste_html tool. See MCP Setup for configuration.

Next Steps

Authentication -- Learn about API keys and auth options
API Reference -- Full endpoint documentation
CLI Guide -- Terminal-based workflows