---
title: "Create email address"
method: POST
path: "/api/e2/email-addresses"
tags: ["Email Addresses"]
---

# Create email address

`POST /api/e2/email-addresses`

Create a new email address for an authenticated user's domain, optionally routing to a webhook or endpoint.

## Request body

- object
  - `address` string, required
  - `domainId` string, required
  - `endpointId` string
  - `webhookId` string
  - `isActive` boolean

## Response `201`

Response for status 201

- object
  - `id` string, required
  - `address` string, required
  - `domainId` string, required
  - `webhookId` string, nullable, required
  - `endpointId` string, nullable, required
  - `isActive` boolean, required
  - `isReceiptRuleConfigured` boolean, required
  - `receiptRuleName` string, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `userId` string, required
  - `domain` object, required
    - `id` string, required
    - `name` string, required
    - `status` string, required
  - `routing` object, required
    - `type` 'webhook' | 'endpoint' | 'none', required
    - `id` string, nullable, required
    - `name` string, nullable, required
    - `config` unknown
    - `isActive` boolean, required
  - `warning` string

## Other responses

- `400` — Response for status 400
- `401` — Response for status 401
- `404` — Response for status 404
- `409` — Response for status 409
- `500` — Response for status 500

---

[API](https://skmtc.dev/stainless-api/apis/inbound-email-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/inbound-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stainless-api/inbound-email-api/revisions/e279d3cb940b/schema)