---
title: "Create an email address for a business"
method: POST
path: "/businesses/{id}/email_addresses"
tags: ["Email addresses"]
---

# Create an email address for a business

`POST /businesses/{id}/email_addresses`

## Path parameters

- `id` string, required

## Request body

- union
  - object
    - `email_address` string, required — The full email address. Must have the same domain as an existing business email address.
    - `display_name` string, required — The display name for the email address
    - `one_off` boolean — Whether this is a one-off email address
    - `reply_to` string — The reply-to address for the email address
  - object
    - `username` string, required — The username (local part) of the email address
    - `display_name` string, required — The display name for the email address
    - `custom_domain` string, required — The ID of the custom domain to create the email address under
    - `one_off` boolean — Whether this is a one-off email address
    - `reply_to` string — The reply-to address for the email address

## Response `200`

The created `EmailAddress` object

- EmailAddress
  - `id` string, required — The ID of the email address
  - `email_address` string, required — The email address
  - `display_name` string, required — The display name of the email address
  - `reply_to` string, nullable, required — The reply-to address
  - `business` string, nullable, required — The business associated with this email address
  - `one_off` boolean, required — Whether the email address is one-off
  - `custom_domain` string, nullable, required — The custom domain associated with this email address

---

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