Create Referral Code

POST

https://tunnelsats.com/api/referral/create

Returns the referral code of your authenticated account and creates it on the first call. The call is idempotent: repeated calls return the same code. Share it as https://tunnelsats.com?ref=<code> or pass it as referralCode to POST /api/public/v1/subscription/create. Each referred 3, 6 or 12-month purchase credits you +1, +2 or +3 bonus months once, when it is paid (listed by GET /api/referral/history). No request body. Rate limit: 30 requests/min per account.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Responses

🟢200

application/json

Your referral code (newly created or existing)

Bodyapplication/json

🟠401

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://tunnelsats.com/api/referral/create' \
--header 'Accept;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "code": "REF-7K2Q9Z",
    "created_at": "2026-01-15 09:30:00",
    "usage_count": 3
}

Modified at 2026-09-28 21:01:05

List Account Subscriptions (Authenticated)

Get Referral Code