Skip to main content
POST
Create a redirect

Authorizations

Authorization
string
header
required

API key issued in the dashboard. Server-side only: never ship it to a browser, and never pass it as a query parameter.

Body

application/json
name
string
required
Required string length: 1 - 100
Example:

"Promo"

target_url
string
required

Where visitors are sent. Only http and https are accepted.

Maximum string length: 2048
Example:

"https://onlyfans.com/kate"

slug
string

Address on the domain. Omit it to place the link at the root of your own domain; on the system domain a slug is required.

Required string length: 3 - 25
Example:

"promo"

note
string

Private note, never shown to visitors.

Maximum string length: 256
Example:

"Autumn mailing"

domain
string

Hostname, the same value that appears in responses. Defaults to the system domain. The domain must already be verified.

Maximum string length: 253
Example:

"teasy.link"

group_id
string
Example:

"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"

is_active
boolean
default:true
antibot_enabled
boolean
default:false

Screens suspicious traffic before redirecting.

geo_blocklists
object

Requires a plan with geo filtering.

Response

id
string
required
Example:

"rdr_9f2c5a4b7d4c31a2f86e0d91b3c7aa10"

object
enum<string>
required
Available options:
redirect
name
string
required
Example:

"Promo"

url
string | null
required

Public address, assembled from the domain and the slug. Null only if the link lost its domain.

Example:

"https://teasy.link/promo"

target_url
string
required
Example:

"https://onlyfans.com/kate"

slug
string | null
required

Null when the link occupies the root of a custom domain.

Example:

"promo"

is_active
boolean
required

Inactive links stop resolving but keep their statistics.

Example:

true

note
string | null
required

Private note, never shown to visitors.

Example:

"Autumn mailing"

antibot_enabled
boolean
required
Example:

false

group_id
string | null
required
Example:

"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"

domain
string | null
required

Hostname as a plain string — the same value is passed when creating a link.

Example:

"teasy.link"

created_at
string<date-time>
required
Example:

"2026-08-21T10:00:00Z"

updated_at
string<date-time>
required
Example:

"2026-08-21T10:00:00Z"

pixels
object[]
required
geo_blocklists
object
required