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

# Add an email

`POST /services/{serviceId}/emails`

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.
    - `faxNumber` 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.
    - `faxNumber` 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.

---

[API](https://skmtc.net/sinch/apis/fax-api.md) · [All operations](https://skmtc.net/sinch/apis/fax-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/fax-api/revisions/ebcbb377ee0f/schema)