Skip to Content
Elido is in closed beta — APIs are stable but rate-limits and quotas may change before GA. Request access →
Getting Started

Getting Started

1. Sign up

Create a free account at elido.app/signup . Free includes 10 links and 1,000 clicks per month — plenty for kicking the tyres.

From the dashboard, click New link, paste a destination URL, and accept the auto-generated slug. The short link looks like https://f.elido.me/Ab3xQ.

You can override the slug with a vanity string from Starter onwards.

3. Hit the API

Generate a Personal Access Token from Settings → API Tokens and shorten a URL from the command line:

curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_url": "https://example.com/my-long-url",
    "workspace_id": 1
  }'

The response includes the slug, the redirect host (based on your tier), and the short URL ready to share:

{
  "id": 42,
  "slug": "Ab3xQ",
  "destination_url": "https://example.com/my-long-url",
  "short_url": "https://s.elido.me/Ab3xQ",
  "workspace_id": 1,
  "created_at": "2026-05-01T12:00:00Z"
}

4. Use an SDK

If you’d rather not write HTTP by hand:

import { ElidoApi } from "@elido/sdk";
 
const api = new ElidoApi({
  baseUrl: "https://api.elido.app",
  token: process.env.ELIDO_TOKEN,
});
 
const link = await api.links.create({
  destination_url: "https://example.com",
  workspace_id: 1,
});

See SDKs for Python and Go equivalents.

What’s next

  • Wire your custom domain — see Authentication for token scopes, then the Domains section of your dashboard.
  • Subscribe to webhooks — see Webhooks.
  • Browse the full surface in the API Reference.
IntroductionAuthentication