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

A unique ending for the page link, e.g., example.com/promo. Lowercase Latin letters and hyphens only; must start and end with a letter. Omit it to place the link at the root of your own domain; on the system domain a slug is required. See How we build links.

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. If you don't provide one when creating, the system domain teasy.link will be used. The custom domain must be active to be used. See Custom Domains.

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