1. 📢 Public
TunnelSats Public Wireguard API
  • About our team
  • 📢 Public
    • List Servers
      GET
    • Create Subscription
      POST
    • Check Status / Heal
      GET
    • Claim Subscription
      POST
    • Renew Subscription
      POST
    • Get Subscription Status
      POST
  • 🔐 Authenticated
    • List My Subscriptions
      GET
    • Sync Subscription
      POST
    • Create Referral Code
      POST
    • Referral History
      GET
  • Announcements
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
  • Cookbook
    • 🛠️ Automation & Code Examples
    • 🐚 Bash One-Liners
    • 🛑 Error Codes & Troubleshooting
    • 🎁 Referral Program: Earn Bonus Months
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • WireGuardConfig
    • ReferralCode
    • ReferralHistory
    • NodeLookup
    • ConnectivityResult
  1. 📢 Public

Create Subscription

POST
/api/public/v1/subscription/create
Creates Lightning invoice for new subscription.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://tunnelsats.com/api/public/v1/subscription/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "serverId": "eu-de",
    "duration": 1,
    "referralCode": null
}'
Response Response Example
{
    "invoice": "lnbc42480n1p5mua4kpp50e6fyyjxg85kx2zpptp96vx75wcz85hapqejlwax0q2a33w6rjzqdzy236kumn9d3fkzarnypq4qjf6yprk2undv9h8jgpgv46j6er99ysz6gp3ypxk7mn5dpescqzzsxqrrsssp5cdl9jqe9scc4uu0nnqr3mxcnnl46q693upp2ur5ht4q25gmh8z5q9qxpqysgqn35l7kfjsm7jwmxadvukzjydm8u02j2dvr4ngz3rhsnfpup0cvzslc6fr6adlyc6y49qys0zed0qhcv73v6jfq0f4uwp4zjxtza6tlgqh7p5w7",
    "paymentHash": "7e7492124641e96328410ac25d30dea3b023d2fd08332fbba67815d8c5da1c84",
    "amountSats": 4248,
    "orderId": "bc5dc608-905a-46db-b443-675ac24e6aa4"
}
Modified at 2026-03-21 10:46:02
Previous
List Servers
Next
Check Status / Heal
Built with