---
title: "emailSender.list"
method: POST
path: "/emailSender.list"
tags: ["Email Sender"]
---

# emailSender.list

`POST /emailSender.list`

> Beta
>
> This endpoint is in beta and may not be available for all organizations.

Lists the email addresses available to the acting identity for sending email through Ashby. Each result identifies whether the address is primary, a personal alias, an organization alias, or a no-reply address available across the organization's brands. Individual sending endpoints may support only a subset of these sender types. In particular, `sequence.add` always rejects `NoReply` senders; listing an address here does not mean that endpoint accepts it.

Without an `X-On-Behalf-Of` header, the acting identity is the API service user, which generally has access to organization-wide and no-reply addresses. Use `X-On-Behalf-Of` to discover the personal addresses available to a specific user.

**Requires the [`sourcingRead`](authentication#permissions-emailsenderlist) permission.**

## Request body

- EmailSenderListRequest

## Response `200`

Responses from the emailSender.list endpoint

- union
  - EmailSenderListSuccessResponse
    - `success` true, required
    - `results` EmailSender[], required
      - `email` string, email, required — The email address that can be used to send a sequence
      - `displayName` string, nullable, required — The display name used when sending from this address, if configured
      - `type` 'Primary' | 'PersonalAlias' | 'OrganizationAlias' | 'NoReply', required — How the address is made available to the acting identity
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

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