create-user.mdx

April 16, 2026 · View on GitHub

import { createClerkClient } from '@clerk/backend'

const clerkClient = createClerkClient({ secretKey: process.env.CLERK_SECRET_KEY })

async function createUser(request) {
  // Use the `request.auth` object to access `isAuthenticated` and the user's ID
  const { isAuthenticated, userId } = request.auth

  // Protect the route from unauthenticated users
  if (!isAuthenticated) {
    return Response.json({ error: 'Unauthorized' }, { status: 401 })
  }

  // Use the `createUser()` method to create the user
  const user = await clerkClient.users.createUser({
    emailAddress: ['test@example.com'],
    password: 'password',
  })

  // Return the Backend User object
  return user
}

```ts {{ filename: 'app/api/example/route.ts' }} import { auth, clerkClient } from '@clerk/nextjs/server' import { NextResponse } from 'next/server'

export async function POST() { const client = await clerkClient()

const user = await client.users.createUser({
  emailAddress: ['test@example.com'],
  password: 'password',
})

return NextResponse.json({ message: 'User created', user })

}

</If>

<If sdk="astro">
```tsx {{ filename: 'src/api/example.ts' }}
import type { APIRoute } from 'astro'
import { clerkClient } from '@clerk/astro/server'

export const POST: APIRoute = async (context) => {
  await clerkClient(context).users.createUser({
    emailAddress: ['test@example.com'],
    password: 'password',
  })

  return new Response(JSON.stringify({ success: true }), { status: 200 })
}

```ts {{ filename: 'public.ts' }} import { getAuth, clerkClient } from '@clerk/express'

app.post('/createUser', async (req, res) => { await clerkClient.users.createUser({ emailAddress: ['test@example.com'], password: 'password', })

res.status(200).json({ success: true })

})

</If>

<If sdk="fastify">
```ts {{ filename: 'src/routes/example.ts' }}
import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify'
import { clerkClient } from '@clerk/fastify'

export const exampleRoutes = (fastify: FastifyInstance) => {
  fastify.post('/createUser', async (req: FastifyRequest, res: FastifyReply) => {
    const user = await clerkClient.users.createUser({
      emailAddress: ['test@example.com'],
      password: 'password',
    })

    res.status(200).json(user)
  })
}

```ts {{ filename: 'server/api/example.ts' }} import { clerkClient } from '@clerk/nuxt/server'

export default defineEventHandler(async () => { const user = await clerkClient.users.createUser({ emailAddress: ['test@example.com'], password: 'password', })

return { user }

})

</If>

<If sdk="react-router">
```tsx {{ filename: 'app/routes/example.tsx' }}
import { clerkClient } from '@clerk/react-router/server'
import type { Route } from './+types/example'
import { json } from 'react-router-dom'

export async function action({ request }: Route.ActionArgs) {
  const formData = await request.formData()
  const emailAddress = formData.get('emailAddress')
  const password = formData.get('password')

  await clerkClient.users.createUser({
    emailAddress: [emailAddress],
    password: password,
  })

  return json({ success: true })
}

```tsx {{ filename: 'app/routes/api/example.tsx' }} import { json } from '@tanstack/react-start' import { createFileRoute } from '@tanstack/react-router' import { clerkClient } from '@clerk/tanstack-react-start/server'

export const ServerRoute = createFileRoute('/api/example')({ server: { handlers: { POST: async () => { await clerkClient().users.createUser({ emailAddress: ['test@example.com'], password: 'my-secure-password', })

      return json({ success: true })
    },
  },
},

})

</If>