List emails

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.