Introduction

The Teasy API gives your own systems the same control over links, landing pages and analytics that the dashboard has. It is REST over JSON, with one production host:

https://api.teasy.link/v1

Your first request

Issue a key on the API Keys page of your dashboard, then list what you already have:

curl https://api.teasy.link/v1/redirects \
  -H "Authorization: Bearer tsl_live_<32 characters>"

Creating a link needs only a name and a target:

curl -X POST https://api.teasy.link/v1/redirects \
  -H "Authorization: Bearer tsl_live_<32 characters>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Promo",
    "target_url": "https://yourcontent.com/kate",
    "slug": "promo"
  }'

The link is served from the system domain teasy.link unless you pass a domain of your own.

Authentication

Bearer key in a header. Server-side only.

Response shapes

Five body forms and the rules every field follows.

Errors

One shape on every status. Match on code, never on message.

Rate limits

Per-minute and per-day windows, shared across your keys.

⌘I

Getting Started

Core Concepts

Working with the API

Your first request

Authentication

Response shapes

Errors

Rate limits

​Your first request

Authentication

Response shapes

Errors

Rate limits

Your first request