Skip to main content

Connect Your App in Userdocks

Use this guide before you start calling the public Userdocks API from your own frontend or backend.

By the end of this setup, you should have:

  • a Userdocks project created or selected
  • a Userdocks app selected in the dashboard
  • any teammates invited to the project if they also need dashboard access
  • redirect URLs configured for your login flow
  • the app UUID available for your API calls
  • Mollie connected in the dashboard if you plan to take payments

Step 1: Create Or Select Your Project​

Before you can create an app, you need a project in Userdocks.

A project is the workspace that contains your app configuration and lets your team collaborate on the same setup. If you are new to Userdocks, create a project first in the dashboard and give it a name that matches the product or environment you are integrating.

If other people on your team need to help manage the app, invite them to this project before or after creating the app. Project members can work together on the app configuration inside the same project.

Step 2: Create Or Select Your App​

Open the Userdocks dashboard and create or select the app you want to integrate. This is the app that will own your users, tenants, login configuration, and payment setup inside your project.

If you are new to Userdocks, start from the Userdocks Introduction and then continue here.

Step 3: Configure Your Public App Settings​

In the dashboard, configure the app settings your public auth flow depends on:

  • add the redirect URL your app will use after login
  • add the public URLs your registration and login flow should expose, such as privacy-policy or terms pages
  • verify that the app is enabled and uses the correct environment

The redirect URL matters because the login code flow validates the redirectUri you send during sign-in against the redirect URLs configured for the app.

Step 4: Copy The App UUID​

Keep the app UUID available in your integration.

You will use it as:

  • appUuid during registration
  • appUuid during login code creation
  • client_id during token exchange

If your frontend and backend both talk to Userdocks, make sure they both use the same app UUID for the same environment.

Step 5: Connect Mollie In The Dashboard If You Need Payments​

If your app needs card setup, one-time payments, or subscriptions, connect Mollie in the Userdocks dashboard before you build the runtime billing flow.

Do this in the dashboard:

  1. Open the app you want to bill through.
  2. Open the payment provider settings.
  3. Start the Mollie connection flow.
  4. Complete the Mollie OAuth and onboarding steps.
  5. Add any missing business information Userdocks asks for.

This connection flow belongs in the Userdocks dashboard. It is not a public API step for your end users.

Step 6: Move On To Runtime Flows​

Once the dashboard setup is finished, continue with:

  1. Register and Login with Userdocks SDKs
  2. Advanced Register, Login, and Tenants if you want to build your own auth UI instead of using the hosted Userdocks pages
  3. Mollie Payments

These guides cover the runtime auth, tenant, and billing flows your app will use after dashboard setup.