---
title: "autumnHandler"
description: "Server-side handler for managing Autumn API endpoints and customer authentication"
---

import LearnHooksTip from '/snippets/learn-hooks-tip.mdx';

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.

<LearnHooksTip />

## 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/webStandard` |
| Express | `autumn-js/express` |
| Other | `autumn-js/backend` |

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

<Note>
The Express adapter requires `express.json()` body-parser middleware before the Autumn handler. See the [setup guide](/documentation/getting-started/setup) for full examples.
</Note>

## Usage

```ts
// 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

<ParamField body="identify" type="(request: Request) => AuthResult" required>
  Function that receives the incoming request and returns customer identification data.
  
  <Expandable title="AuthResult">
    <ParamField body="customerId" type="string" required>
      The unique identifier for the customer.
    </ParamField>

    <ParamField body="customerData" type="CustomerData">
      Additional metadata about the customer (e.g., `name`, `email`).
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="secretKey" type="string">
  Autumn API secret key. Defaults to `AUTUMN_SECRET_KEY` environment variable.
</ParamField>

<ParamField body="autumnURL" type="string">
  Override the Autumn API URL. Use when self-hosting.
</ParamField>

<ParamField body="pathPrefix" type="string">
  Path prefix for routes. Defaults to `/api/autumn`.
</ParamField>

<ParamField body="suppressLogs" type="boolean">
  If true, suppresses console warnings and logs.
</ParamField>