---
title: "Add an email"
method: POST
path: "/v3/projects/{projectId}/services/{serviceId}/emails"
tags: ["Fax to Email"]
---

# Add an email

`POST /v3/projects/{projectId}/services/{serviceId}/emails`

## Request

- Base URL: `https://fax.api.sinch.com`
- URL: `https://fax.api.sinch.com/v3/projects/{projectId}/services/{serviceId}/emails`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.sinch.com/oauth2/token`

Add an email to the specified service to be used for sending and receiving faxes. Default settings for permissions parameter is `both`.

## Path parameters

- `serviceId` string, required

## Request body

- Email
  - `email` string, email, required
  - `phoneNumbers` Number[], required: Numbers you want to associate with this email.
    - `number` string, phoneNumber: A phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format, including the leading '+'.
    - `permissions` 'both' | 'send' | 'receive': Allows you to set permissions for sending and receiving faxes to this email/phone number combination. Default value is `both`.
  - `projectId` string: The `Id` of the project associated with the call.
  - `createdAt` string, date-time: The date and time the email configuration was created.
  - `updatedAt` string, date-time: The date and time the email configuration was last updated.

## Response `201`

The added email

- Email
  - `email` string, email, required
  - `phoneNumbers` Number[], required: Numbers you want to associate with this email.
    - `number` string, phoneNumber: A phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format, including the leading '+'.
    - `permissions` 'both' | 'send' | 'receive': Allows you to set permissions for sending and receiving faxes to this email/phone number combination. Default value is `both`.
  - `projectId` string: The `Id` of the project associated with the call.
  - `createdAt` string, date-time: The date and time the email configuration was created.
  - `updatedAt` string, date-time: The date and time the email configuration was last updated.

## Changes

- **2026-10-08** `7c729cfeab72`: 2 warning, 2 info
  - removed the request property `phoneNumbers/items/faxNumber`
  - removed the optional property `phoneNumbers/items/faxNumber` from the response with the `201` status
  - added the new optional request property `phoneNumbers/items/number`
  - added the optional property `phoneNumbers/items/number` to the response with the `201` status
- **2026-10-01** `7f5e54fa9f05`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sinch/apis/fax-api/changes/v3/projects/:projectId/services/:serviceId/emails/post.md)

---

[API](https://skmtc.dev/sinch/apis/fax-api.md) - [All operations](https://skmtc.dev/sinch/apis/fax-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/fax-api/revisions/d3054d7412d5?raw)