This is a template for a Next.js app that uses Clerk for authentication and multi-tenant Tinybird real-time analytics applications.

1. Create a new Clerk application
2. Create a new Tinybird workspace
3. Create an .env file from the .env.example file and fill in the values
4. Run npm install
5. Run npm run dev

In Clerk (Dashboard > Configure > JWT templates) choose the Tinybird JWT template:

Modify the claims to your needs:

{	"name": "frontend_jwt",	"limits": {	"rps": 10	},	"scopes": [	{	"type": "PIPES:READ",	"resource": "<YOUR-TINYBIRD-PIPE-NAME>",	"fixed_params": {	"org": "{{org.slug}}",	"user": "{{user.id}}"	}	}	],	"workspace_id": "<YOUR-TINYBIRD-WORKSPACE-ID>" } 

• Use your Tinybird admin token as signking key.
• Add as many scopes as needed, use fixed params to filter your Tinybird API endpoints.
• Configure fixed_params to match the parameter names and values in your Tinybird API endpoints.

Example:

NODE endpoint SQL > SELECT * FROM ds WHERE 1 {% if defined(org) %} AND org = {{String(org)}} {% end %} {% if defined(user) %} AND user = {{String(user)}} {% end %} TYPE endpoint

On your application request a token to Clerk using the tinybird template, where tinybird is the name you gave to the template.

 const authentication = await auth() const { userId, sessionId, getToken } = authentication const token = await getToken({ template: "tinybird" }) fetch('https://api.tinybird.co/v0/pipes/your_pipe.json', { headers: { Authorization: `Bearer ${token}` } })

On Sign In, the app authenticates with Clerk, the middleware picks up the session and creates a multi-tenant Tinybird JWT token using the tinybird JWT template from Clerk, finally adds the token to the response headers to be used by the application.

Use the token to query Tinybird as the authenticated user.

• Use Clerk to manage users and organizations.
• Assign organizations to users and define organization permissions.
• Use those organization permissions to create multi-tenant Tinybird JWT tokens using the fixed_params feature.

Please open an issue or submit a pull request.

Join the Tinybird Slack community to get help with your project.

Learn more about Tinybird JWT tokens and Clerk.

MIT License

Copyright (c) 2025 Tinybird.co