Emailit icon

Emailit

Transactional email platform. Send emails, manage domains, templates, audiences, webhooks, suppressions, contacts, and verify emails via the Emailit API.

Actions52

Contacts → List contacts

AI-generated

Summary

List contacts from the Emailit API, supporting pagination, filtering, and custom request options.

Inputs

  • Return All — Whether to return all contacts by retrieving all pages or only a single page of results.
  • Additional Fields — Optional pagination parameters: 'Page' to specify the page number and 'Limit' to specify the number of contacts per page.
  • Options — Advanced settings including custom JSON body to send, custom HTTP headers, query-string filters, batching parameters (items per batch, interval), debug mode to include request details in output, pagination configuration (pagination mode, parameter names, start values, max pages, intervals), and request timeout in milliseconds.

Output shape

a list/array of contact objects as returned by the Emailit API

Supports different pagination modes (offset, cursor, or next URL) configurable in options. When 'Return All' is false, only a single page is returned. Debug information can be included optionally. Custom headers and query parameters can be supplied for advanced filtering or authentication scenarios.

Examples

Example 1: Retrieve all contacts across all pages with default pagination.

Set 'Return All' to true; optionally adjust pagination settings under options.

Example 2: Retrieve first page of contacts with a limit of 20 contacts.

Set 'Return All' to false, set 'Page' to 1 and 'Limit' to 20 under Additional Fields.

Example 3: Add custom HTTP headers and query filters to refine the contacts request.

Use the 'Options' collection to add 'Custom Headers' and 'Query Filters' accordingly.

Links

Discussion