Create Redirect
Everything that can fail without writing fails first: the domain, the country codes, the plan. The response is the full card, same shape as GET /v1/redirects/.
Authorizations
API key issued in the dashboard. Server-side only: never ship it to a browser, and never pass it as a query parameter.
Body
1 - 100"Promo"
Where visitors are sent. Only http and https are accepted.
2048"https://onlyfans.com/kate"
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.
3 - 25"promo"
Private note, never shown to visitors.
256"Autumn mailing"
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.
253"teasy.link"
"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"
Screens suspicious traffic before redirecting.
Requires a plan with geo filtering.
Response
"rdr_9f2c5a4b7d4c31a2f86e0d91b3c7aa10"
redirect "Promo"
Public address, assembled from the domain and the slug. Null only if the link lost its domain.
"https://teasy.link/promo"
"https://onlyfans.com/kate"
Null when the link occupies the root of a custom domain.
"promo"
Inactive links stop resolving but keep their statistics.
true
Private note, never shown to visitors.
"Autumn mailing"
false
"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"
Hostname as a plain string — the same value is passed when creating a link.
"teasy.link"
"2026-08-21T10:00:00Z"
"2026-08-21T10:00:00Z"