sender/errors_by_id
Tool: read
List send-time error records for a sender.
Returns a paginated list of error events recorded for the sender — SMTP/IMAP failures, warmup disconnections, and related send-time errors. This list covers send-time events only; for current connection state, check disconnected, dateDisconnected, and disconnectionReason on the sender object itself (see sender/get_by_id and schemas/sender).
This list may be empty even for a disconnected sender — the authoritative connection state is on the sender object itself (
disconnected,disconnectionReason,dateDisconnected).
Arguments
| name | type | req | notes |
|---|---|---|---|
| id | integer | ✓ | Sender ID — the object's senderId (int64) |
Response
200 — Paginated list; object: {items: SenderError[], pagination}. Pagination: see schemas/pagination.
| field | type | notes |
|---|---|---|
| items[].errorId | integer | int64 |
| items[].createdAt | string | date-time (UTC) |
| items[].campaignId | integer | Campaign associated with the error (if any) |
| items[].followupId | integer | int64; followup associated (if any) |
| items[].senderId | integer | int64 |
| items[].action | string | Error category (e.g. send_gmail_oauth, receive_imap, warmup_disconnected) |
| items[].context | string | Additional context such as email address or ID; max 128 chars |
| items[].message | string | Brief error message; max 512 chars |
| items[].description | string | Detailed error description; max 4000 chars |
Errors: 400, 401, 404, 406, 422, 429, 500 — shared schema: schemas/errors.
Invoke
Call read with name: "sender/errors_by_id".