Getting started
Pairing a phone
Pairing links a phone to your account with a single-use PIN. It takes about a minute and needs no cables or configuration files.
- 1Get a PINOn the dashboard, the empty state shows a pairing PIN. It's single-use, tied to your account, and expires after about three minutes — a fresh one is one click away.
- 2Enter it in the appOpen the app, tap Pair with PIN, and type the code. The app talks to us over the cellular network to redeem it, so a Wi-Fi captive portal can't interfere.
- 3Grant background permissionsThe app guides you through the battery and background permissions it needs to hold the tunnel with the screen off. This is the single most important step for a proxy that stays online — see Troubleshooting.
- 4Confirm it's onlineThe phone shows up on your dashboard with a green Online status, its carrier, and its current exit IP. You're ready to create a proxy credential.
Pairing over the API
Create a subscription first, then call
POST /api/v1/subscriptions/{id}/pair to mint the short-lived PIN. See the API guide.Re-pairing and unlinking
To replace the phone while preserving the subscription, proxy endpoints, and history, mint a new PIN with POST /api/v1/subscriptions/{id}/pair. DELETE /api/v1/subscriptions/{id} irreversibly cancels the entire subscription; it is not an unpair operation.
What the PIN does and doesn't share
The PIN only authorizes this one phone to join your account. It carries no personal data, works only on your account, and is useless once redeemed or expired.