Skip to main content

​
What is a Handle?

A handle gives you a personalized URL at yourname.simplehost.dev. It’s like a username for your SimpleHost profile.
Handles are available on the Hobby plan ($4/mo) only.

​
Setting Your Handle

  1. Go to simplehost.dev/dashboard
  2. Click the Handle tab
  3. Enter your desired handle
  4. Click Save Changes

​
Handle Rules

  • Lowercase letters, numbers, and hyphens only
  • Cannot start or end with a hyphen
  • Must be unique across all users
  • Can be changed at any time (your old handle is released)

​
Using Your Handle

Once set, your handle URL (yourname.simplehost.dev) is active. You can configure what it points to in the dashboard.

​
Managing via API

# Get your current handle
curl -X GET https://simplehost.dev/api/v1/handle \
  -H "Authorization: Bearer sh_live_your_key_here"

# Set or update your handle
curl -X PUT https://simplehost.dev/api/v1/handle \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sh_live_your_key_here" \
  -d '{"handle": "yourname"}'