Create links via the API

Create a short link with one authenticated JSON request:

curl https://goto.now/api/v1/links \
  -H "Authorization: Bearer gtn_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page","slug":"launch"}'

url is required. slug is optional and accepts 3–60 letters, numbers, dashes, or underscores. HTTP 201 returns shortUrl, shortCode, and dashboardToken; API-created links appear in the same dashboard as links made by hand. A 400 means the payload is invalid, 401 means the key is missing or inactive, 429 means the per-key rate limit was reached, and 502 means the redirect engine rejected the creation.

Use GET /api/v1/links with the same header to list the account's newest 200 links. See the developer reference for conversion events and signed webhooks.