---
ref: tool:instantly/list-emails
name: List emails
company: company:instantly
workflows: [workflow:cold-email-reply-triage, workflow:referral-reply-leads]
access: [api]
tags: [capability:search-conversations, category:sales-engagement, has:api]
docs: https://developer.instantly.ai/api-reference/email/list-email
updated: 2026-09-29
---

# List emails

Returns the emails in the workspace's Unibox, newest first, filtered by campaign, type or sending account, such as only the replies received, or searched by a lead's email address.

Note: Pass `email_type=received` for replies and `campaign_id` to narrow them to one campaign. Page with `limit`, up to 100, and `starting_after`, set to the previous response's `next_starting_after`.

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.instantly.ai
- Endpoint: `GET /api/v2/emails`
- Auth: send the header `Authorization: Bearer $INSTANTLY_API_KEY`
- Get a key: https://app.instantly.ai/app/settings/integrations
- Docs: https://developer.instantly.ai/getting-started/authorization

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.