Alireza EsmikhaniA
Convex Community•4mo ago•
1 reply
Alireza Esmikhani

Doc Issue: Wrong applicationID in WorkOS AuthKit example

Hey Convex team 👋

I noticed a small but important issue in the AuthKit documentation (https://docs.convex.dev/auth/authkit/). In the example for auth.config.ts, the applicationID field is incorrectly included in the second provider configuration (the one with issuer: https://api.workos.com/user_management/${clientId}).

Here’s the snippet from the docs:

const clientId = process.env.WORKOS_CLIENT_ID;

const authConfig = {
  providers: [
    {
      type: 'customJwt',
      issuer: `https://api.workos.com/`,
      algorithm: 'RS256',
      jwks: `https://api.workos.com/sso/jwks/${clientId}`,
      applicationID: clientId,
    },
    {
      type: 'customJwt',
      issuer: `https://api.workos.com/user_management/${clientId}`,
      algorithm: 'RS256',
      jwks: `https://api.workos.com/sso/jwks/${clientId}`,
      applicationID: clientId, // :x: This shouldn't be here
    },
  ],
};

export default authConfig;


The second provider (user_management) should not include applicationID. Removing that line fixes the issue — it took me nearly two days to track this down 😅 so I thought I’d share to help others avoid the same problem.
Was this page helpful?