API reference

The fewly REST API lets you create and manage links programmatically. It's available on paid plans and authenticated with a workspace-scoped API key. Base URL: https://fewly.tech/api/v1

Authentication

Create a key in Settings → API keys, then pass it as a bearer token. Keep it secret.

Create a link

curl -X POST https://fewly.tech/api/v1/links \
  -H "Authorization: Bearer fwly_xxx_yyy" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com", "code": "launch"}'

List links

curl https://fewly.tech/api/v1/links \
  -H "Authorization: Bearer fwly_xxx_yyy"

Rate limits & errors

Requests are rate-limited per key and vary by plan; a 429 means back off and retry. Errors return a JSON body with a detail message.

Interactive schema

The full OpenAPI schema is at /api/schema/, with an explorer at /api/docs/.