autumnHandler

The autumnHandler creates server-side endpoints that handle communication between your frontend React hooks and Autumn’s API. It manages customer authentication and proxies requests securely using your secret key.

Learn how to setup Autumn hooks in the Getting Started guide.

Framework adapters

Import the handler from the adapter that matches your backend framework:

Framework	Import path
Next.js	`autumn-js/next`
Hono	`autumn-js/hono`
Elysia / Web Standard	`autumn-js/fetch`
Express	`autumn-js/express`
Other	`autumn-js/backend`

The Web Standard adapter (autumn-js/fetch) works with any runtime that uses the Fetch API Request/Response objects, including Elysia, Cloudflare Workers, and Deno.

The Express adapter requires express.json() body-parser middleware before the Autumn handler. See the setup guide for full examples.

Usage

// app/api/autumn/[...all]/route.ts
import { autumnHandler } from "autumn-js/next";
import { auth } from "@clerk/nextjs/server";

export const { GET, POST } = autumnHandler({
  identify: async () => {
    const { userId } = await auth();
    return { customerId: userId };
  },
});

Parameters

(request: Request) => AuthResult

required

Function that receives the incoming request and returns customer identification data.

Show AuthResult

string

required

The unique identifier for the customer.

CustomerData

Additional metadata about the customer (e.g., name, email).

string

Autumn API secret key. Defaults to AUTUMN_SECRET_KEY environment variable.

string

Override the Autumn API URL. Use when self-hosting.

string

Path prefix for routes. Defaults to /api/autumn.

boolean

If true, suppresses console warnings and logs.

⌘I

Getting Started

Configure Pricing

Billing & Subscriptions

Customers

Additional Resources

Framework adapters

Usage

Parameters

​Framework adapters

​Usage

​Parameters

Framework adapters

Usage

Parameters