Clerk

Connect Clerk to your Workspace to manage users, organizations, invitations, and sessions directly from Luo.

What Luo can do

  • Users — search, view, create, update, and delete users, and get your total user count
  • Account access — ban and unban users, and lock and unlock user accounts
  • Organizations — list, search, view, create, and update organizations
  • Memberships — list an organization’s members, change a member’s role, remove members, and see which organizations a user belongs to
  • Invitations — invite people to an organization by email, and send, list, and revoke app-level invitations
  • Sessions — list and view sessions (optionally for one user), and revoke a session to force a sign-out
  • Waitlist — list waitlist entries and add an email to the waitlist
  • Allowlist and blocklist — list, add, and remove identifiers that are allowed or blocked from signing up and signing in
  • Billing — view your billing plans and a user’s or organization’s subscription (read-only)
  • Sign-in tokens — create a sign-in token (magic link) for a user

Luo asks you to confirm before actions such as creating or deleting a user, banning or locking a user, sending an invitation, revoking a session or invitation, changing your blocklist, and creating a sign-in token.

How to connect

Clerk connects with your instance’s Secret Key. Clerk is a workspace integration — one connection is shared across your workspace’s members.

1. Copy your Clerk Secret Key

  1. Sign in to the Clerk Dashboard and select the application you want to connect.
  2. Open API Keys.
  3. Copy the Secret Key — it starts with sk_live_ for a production instance.

To try Luo on a development instance first, copy that instance’s key instead — it starts with sk_test_, and the connection is labeled Clerk (Test).

2. Connect Clerk in Luo

  1. Open your workspace in Luo, go to Settings → Integrations, and click Add Integration.
  2. Select Clerk.
  3. Paste your Secret Key from step 1.
  4. Click Create Integration. Luo checks the key with Clerk before saving it.

Good to know

  • App-level and organization invitations are separate. An app-level invitation invites someone to your application; an organization invitation invites them to one organization. Luo can list and revoke app-level invitations only.
  • Signing a user out everywhere means revoking each of their sessions — Luo lists the user’s sessions and revokes them one by one.
  • Metadata updates replace the whole object. Updating a user’s or organization’s metadata overwrites existing keys rather than merging, so ask Luo to keep any values you still need.
  • Allowlist and blocklist only take effect once they’re enabled under Restrictions in the Clerk Dashboard.
  • Billing must be enabled in the Clerk Dashboard. A user or organization with no subscription is on your free plan.

Privacy and data handling

Your Secret Key gives Luo full access to your Clerk instance’s backend API, and Luo stores it encrypted. Data flowing through Luo is governed by Luo’s security and privacy practices.

To revoke access, remove the integration in Luo. To make sure the key itself can no longer be used, rotate it under API Keys in the Clerk Dashboard.