Getting Started

Get up and running with perpetua.sh in a few minutes.

1. Sign up

Create an account at perpetua.sh. You can sign up with your email or a social login.

2. Connect a provider

From your dashboard, click Connect and choose a provider (e.g., Oura Ring or Google Calendar). You'll be redirected to the provider's OAuth consent screen. After granting access, you'll be sent back to the dashboard with the connection active.

3. Create an API key

Go to the API Keys section in your dashboard and create a new key. Your key will have a pk_ prefix. Copy it and store it somewhere safe -- it won't be shown again.

4. Make your first request

Use your API key as a Bearer token to call any connected provider through the proxy:

curl -H "Authorization: Bearer pk_your_key" \
  "https://www.perpetua.sh/api/proxy/oura/v2/usercollection/daily_activity"

That's it. Perpetua handles token refresh transparently -- your API key stays valid as long as the provider connection is active.

Google Calendar example

curl -H "Authorization: Bearer pk_your_key" \
  "https://www.perpetua.sh/api/proxy/gcal/calendars/primary/events?maxResults=5"

Next steps