Onboarding Guide
Setup GuideOnboarding Guide & Setup
Before writing your integration code, you must initialize your Authepy workspace, define your public brand identity, select your infrastructure tier, and provision your cryptographic API keys. This guide walks you chronologically through the dashboard pipeline.
Account Initialization
Begin by navigating to the Sign Up page. You can initialize your workspace instantly using Google or GitHub OAuth, or utilize a traditional work email and zero-knowledge password (minimum 8 characters). During this step, Authepy provisions your isolated logical partition on our edge routers and secures your session using Turnstile bot-protection.
authepy.
Initialize your zero-trust workspace.
Workspace Identity & Profile
Once authenticated, you will be directed to your Authepy Console for Workspace Settings. This step is critical because the data you provide here directly dictates how your brand is perceived by your end-users and how we communicate with your engineering team.
- Brand/Company Name & Logo: The business name you input here will be publicly visible to your customers inside the OTP verification emails we dispatch on your behalf. Upload a recognizable logo (JPG/PNG under 1MB).
- Primary Admin Email: Ensure this is accurate. All crucial future communications—including billing invoices, quota alerts, and security notifications—will be routed to this inbox.
- Invoice Information: Complete your company address, City, Country, and optional Tax/VAT ID to ensure your Stripe receipts are compliant for accounting purposes.
Workspace Identity
This is your company's primary identifier on Authepy.
Select Infrastructure Plan
After saving your profile, you will be routed to the Billing & Quotas page. By default, your workspace is entitled to the free Sandbox Plan, which provides 3,000 OTP dispatches per month over our shared IP pool to help you prototype safely.
For production workloads, you can select a plan suitable for your business scale. Selecting "Launch" ($29/mo, 20,000 OTPs) or "Scale" ($99/mo, 150,000 OTPs) will securely redirect you to Stripe to process your payment settings. Upon successful payment processing, Stripe will redirect you back to the Authepy Console.
- ✓ 3,000 OTPs/mo
- ✓ 100 OTPs/day
- ✓ Shared IP Pool
- ✓ Basic Abuse Filter
- ✓ 20,000 OTPs/mo
- ✓ Edge rate limit
- ✓ Deliverability webhooks
- ✓ 7-day log retention
- ✓ 150,000 OTPs/mo
- ✓ VIP Delivery Lanes
- ✓ Brand Identity
- ✓ 30-day log retention
- ✓ Unlimited Volume
- ✓ Dedicated SLAs
- ✓ High Availability
- ✓ Dedicated Supprot
Generate Cryptographic Keys
With your plan active, navigate to the API Keys page. Authepy enforces a dual-key architecture. It is imperative that you select one of the correct key type for your platform to prevent abuse.
Standard Secret Keys
These keys begin with ath_sec_live_. They are strictly for backend applications (Node.js, Express, Next.js Server Actions) where they will never be publicly exposed.
Restricted Domain Keys
Public Safe
These keys begin with rk_live_. They are designed to control and limit usage where keys are exposed, such as React SPAs, Webflow, or Wix site builders. You must define your exact domain name properly before generating this key to prevent misuse.
Upon generation, your Secret Keys are visible only once. Ensure you copy it and save it safely in your environment variables. You can instantly revoke and generate new credentials by pressing the "Roll Secret Key" button whenever you want without breaking the dashboard, but you must quickly update your integrating website/app with the new key to restore functionality.
Test the Edge in the Sandbox
Before jumping to the Integration Guide to write code, you can immediately test the functioning of your keys in the Interactive Sandbox. Enter a test email address and click "Send Test OTP". The live terminal will stream the edge routing latency, and you can enter the received 6-digit code to verify the connection. This guarantees your account and our edge solution are functioning perfectly.
Monitor Logs & Quotas
As your application scales, transparency is vital. The Request Logs section will show all the OTPs that have been dispatched and verified using your keys, along with their exact status and latency in real time.
| Timestamp | Event | Target Identity | Status |
|---|---|---|---|
| 2026-07-01 10:45 | otp.verify | test@valipod.com | VERIFIED |
| 2026-07-01 10:42 | otp.send | test@valipod.com | DELIVERED (1.42s) |
Returning to the Billing & Quotas page will show your live usage metrics: how many OTPs have been sent, and the remaining capacity allowed for the month based on your selected tier.
Engineering Support
For any support related to accounts, setup, or technical architecture, you can click on the Support tab. Select your routing category (e.g., API/Integration, Deliverability), define the priority, and send a detailed message containing payload examples or error codes for a quick response directly from our engineering team.