---
title: "Get inbound email address for a board"
method: GET
path: "/projects/{id}/inbound-email"
---

# Get inbound email address for a board

`GET /projects/{id}/inbound-email`

## Request

- Base URL: `https://craaft.io/api/v1`
- URL: `https://craaft.io/api/v1/projects/{id}/inbound-email`
- Auth: HTTP bearer

Board admins on Pro boards only. Returns the configured intake address
(if enabled) or `{enabled: false}` when not yet set up.

## Response `200`

OK

- object
  - `enabled` boolean, required
  - `aiAvailable` boolean, required: Whether this server can write AI cards (has an AI key)
  - `aiUsage` object, required: AI cards used this calendar month (UTC) across the board's workspace, against the plan's monthly limit. Past the limit, email threads become standard cards until the month ends.
    - `used` integer, required
    - `limit` integer, required: 50 on Pro
  - `address` InboundEmailAddress
    - `email` string, email, required: The board's inbound email address (auto-generated from token + domain)
    - `token` string, required: Routing token; used to construct the address. Unique per board.
    - `targetColumn` string, nullable, required: Column key to place inbound cards; null=first column
    - `active` boolean, required: Whether to accept inbound mail to this address
    - `aiEnrich` boolean, required: AI cards for email threads are on
    - `createdAt` string, date-time, required

## Other responses

- `401`: Missing or invalid token
- `402`: Free plan
- `403`: Not a board admin
- `404`: Resource doesn't exist or caller isn't a member of its workspace

---

[API](https://skmtc.dev/craaft/apis/craaft-api.md) · [All operations](https://skmtc.dev/craaft/apis/craaft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craaft/apis/craaft-api/revisions/3a1e9d30d7dc?raw)