---
title: "POST /v1/routes"
method: POST
path: "/v1/routes"
---

# POST /v1/routes

`POST /v1/routes`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-better-auth.session_token`

Draw an edge: mail for the handle's address is delivered into the mailbox.

## Request body

- RouteCreate
  - `handleId` string, required
  - `mailboxId` string, required

## Response `201`

The request has succeeded and a new resource has been created as a result.

- Route
  - `handleId` string, required
  - `mailboxId` string, required
  - `createdAt` string, date-time, required

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/foundermail/apis/org.md) - [All operations](https://skmtc.dev/foundermail/apis/org/llms.txt) - [OpenAPI document](https://skmtc.dev/foundermail/apis/org/revisions/8bbb36e378ab?raw)