Authentication

Updated May 02, 2026

Dashboard authentication

Splithook uses email + password authentication with a 30-day remember-me cookie. There is no OAuth or SSO in the current version.

Registration

  1. Go to splithook.com/register.
  2. Enter your email and a password (min 8 chars).
  3. A workspace is created automatically with you as Owner.
  4. You receive a verification email — click the link to verify your address.
<div class="callout callout-info"> <svg class="callout-icon" viewBox="0 0 16 16" fill="none" stroke="#38bdf8" stroke-width="1.5"><circle cx="8" cy="8" r="6"/><path d="M8 11V7M8 5h.01"/></svg> <div> <strong>Email verification is required</strong> <p>Some features (inviting team members, billing) require a verified email. If you didn't receive the email, use <strong>Resend verification</strong> from the dashboard banner.</p> </div> </div>

Password reset

Go to the login page → Forgot password → enter your email. A reset link is valid for 30 minutes.

Capture endpoint — no auth

The webhook capture endpoint (/e/{slug}) is intentionally unauthenticated. External providers (Stripe, GitHub…) POST to it directly — they can't send session cookies or bearer tokens. Security on the ingest side is handled by:

  1. Slug obscurity — 8 base32 characters, ~1 trillion combinations. Rotate at any time if compromised.
  2. Signature verification — downstream, when you configure a signing secret, Splithook verifies the provider's HMAC on every request.

API tokens (coming soon)

The REST API is not yet available in this version. When released, it will use workspace-scoped bearer tokens. See REST API reference for the planned shape.

Team invitations

Owners and Admins can invite collaborators by email from Settings → Team → Invite. The invitation is valid for 7 days. When the recipient clicks the link:

Invitations can be revoked from the Settings page before they're accepted.

Roles

Role Invite Manage endpoints Delete workspace Billing
Owner ✓ ✓ ✓ ✓
Admin ✓ ✓ ✗ ✗
Member ✗ ✓ ✗ ✗

The Owner role cannot be transferred or demoted via the UI. Contact support to transfer workspace ownership.