sender/get

Tool: read

List senders with optional filters and pagination.

Returns a paginated list of sender accounts for the authenticated organization. Supports filtering by folder, status, warmup state, or text search. Sender object fields: see schemas/sender. A sender added or changed in the web app can take a few minutes to appear here, search included — never conclude from one empty read that it does not exist (call-contract).

Arguments

name	type	req	notes
folder	string	–	Filter by folder name
status	string	–	Filter by status — no published value list; `error` is the only value known to work, so an empty page for any other value proves nothing
warmup	boolean	–	Filter by warmup state
search	string	–	Search by first name, last name, or email
page	integer	–	Page number, 1-indexed (default 1)
limit	integer	–	limit default 30, max 30; see schemas/pagination
startingAfter	integer	–	Cursor for next page (int64)

Auditing many senders (e.g. warmup health across an organization)? Narrow with warmup / status: "error" / search instead of paging the whole list — the filters answer most audit questions in a fraction of the calls.

Response

200 — Paginated list; object: {items: Sender[], pagination}; each item: see schemas/sender. Pagination: see schemas/pagination. Deltas: none.

Errors: 400, 401, 406, 422, 429, 500 — shared schema: schemas/errors.

Invoke

Call read with name: "sender/get".