Skip to main content

API Introduction

Userdocks helps you launch web applications faster by providing authentication, authorization, user lifecycle management, billing, and growth tooling behind a single REST API.

This API section is the technical guide for integrating Userdocks into your frontend and backend services. It explains how to:

  • authenticate users in client-facing flows
  • authorize access to protected resources
  • manage users and tenants from your own backend
  • run subscription and one-time payment flows
  • connect webhook and billing operations for Mollie-based integrations

If you are starting a new billing integration, use Mollie. Stripe payment flows remain in the reference for existing installations, but they are deprecated for new setups.

If you are building with Userdocks for the first time, start with the official SDKs and the hosted Userdocks auth pages. Use the public auth endpoints directly only when you need a custom register or login flow in your own UI.

Endpoint Groups​

Endpoints are grouped by exposure and auth model so you can quickly find the correct contract for each context:

  • external/public: no auth middleware, used for public app flows
  • external/private-bearer: JWT-protected endpoints for authorized actors
  • external/private-api-key: app-to-app operations authenticated with API key headers
  • internal/public: unauthenticated internal lookup endpoints
  • internal/private-bearer: dashboard/operator endpoints protected by bearer auth

The main sidebar in this documentation focuses on the external routes that app integrators use directly. Internal routes remain implementation reference and are intentionally not part of the public navigation flow.

Use this reference together with your app architecture: clients should call only endpoints intended for public or user-authorized flows, while sensitive management actions should stay on trusted server paths.

Next Step​

Start with Connect Your App in Userdocks, then continue with Register and Login with Userdocks SDKs.

If you want to build your own forms instead of using the hosted Userdocks auth pages, use Advanced Register, Login, and Tenants.

Read the Mollie Payments Guide when you are ready to add card setup, one-time payments, and subscriptions.

Continue to Endpoint Reference for base paths, auth headers, error envelope details, and full route coverage.