# Listrak Email API

> REST API for managing email contacts, lists, segmentation, campaigns, transactional and saved messages, imports, and engagement analytics.
> Base URL `https://api.listrak.com/email`. Auth: OAuth2 client_credentials at `https://auth.listrak.com/OAuth2/Token` (Bearer token).
> Collections are cursor-paginated — page with `cursor` and follow `nextPageCursor` (there is no offset/`startIndex`).
> This documentation is plain markdown, designed to be fetched and read directly by coding agents.

## Start here
- [Getting started](https://api-docs.tools.listrak.com/email/guides/getting-started.md): get an OAuth2 token and make your first authenticated request (TS + Python)
- [Authentication (OAuth2)](https://api-docs.tools.listrak.com/email/guides/authentication.md): client_credentials flow, token caching, scopes, 401 handling
- [Pagination (cursor-based)](https://api-docs.tools.listrak.com/email/guides/pagination.md): page collections with `cursor` and `nextPageCursor` — there is no offset/`startIndex`
- [Errors & retries](https://api-docs.tools.listrak.com/email/guides/errors.md): the `{status,error,message}` envelope, retryable vs non-retryable, the ERROR_* codes
- [PII & logging](https://api-docs.tools.listrak.com/email/guides/pii-logging.md): never log raw email/phone; safe identifiers (emailKey/universalEmailKey) and redaction
- [Copy-paste client & recipes](https://api-docs.tools.listrak.com/email/guides/recipes.md): full TypeScript + Python client, subscribe a contact, send a transactional message

## Core resources
- [Contact](https://api-docs.tools.listrak.com/email/reference/contact.md): The Contact resource is used to add, update and remove new contacts to a List. This resource also exposes the ability to set a …
- [List](https://api-docs.tools.listrak.com/email/reference/list.md): Lists represent groupings of contacts, messages, and more.
- [SegmentationField](https://api-docs.tools.listrak.com/email/reference/segmentation-field.md): A Profile Field is used to store data about a contact so that it can be filtered in the future.
- [SegmentationFieldGroup](https://api-docs.tools.listrak.com/email/reference/segmentation-field-group.md): A Profile Field Group is used to group the profile fields for a given list.
- [ContactSegmentationField](https://api-docs.tools.listrak.com/email/reference/contact-segmentation-field.md): The Contact Segmentation Field resource is used to update contact profile fields.

## Sending
- [TransactionalMessage](https://api-docs.tools.listrak.com/email/reference/transactional-message.md): A Transactional Message resource provides a way to access transactional messages that have been created on a list.
- [SavedMessage](https://api-docs.tools.listrak.com/email/reference/saved-message.md): The Saved Message resource allows you to access saved messages that have been created on a list.
- [Message](https://api-docs.tools.listrak.com/email/reference/message.md): The Message resource provides a way to send and retrieve messages for a list.
- [Campaign](https://api-docs.tools.listrak.com/email/reference/campaign.md): A Campaign resource is used to group and track messages with a common theme or purpose.

## Import & export
- [ListImport](https://api-docs.tools.listrak.com/email/reference/list-import.md): The List Import resource is used to supply an import file in order to import data to a list.
- [ListImportStatus](https://api-docs.tools.listrak.com/email/reference/list-import-status.md): The List Import Status resource allows you to access the status of a list import.
- [ListImportSummary](https://api-docs.tools.listrak.com/email/reference/list-import-summary.md): The List Import Summary resource allows you to access an aggregated summary of a list import.
- [ListImportContact](https://api-docs.tools.listrak.com/email/reference/list-import-contact.md): The List Import Contact resource allows you to access contacts that were affected as result of a list import.

## Analytics
- [MessageSummary](https://api-docs.tools.listrak.com/email/reference/message-summary.md): The Message Summary resource allows you to access an aggregated summary of contact activity for a message.
- [MessageActivity](https://api-docs.tools.listrak.com/email/reference/message-activity.md): The Message Activity resource allows you to access contact activity for a message.
- [MessageLink](https://api-docs.tools.listrak.com/email/reference/message-link.md): The Message Link resource allows you to access links for a message.
- [MessageLinkClicker](https://api-docs.tools.listrak.com/email/reference/message-link-clicker.md): The Message Link Clicker resource allows you to access contacts that clicked a link in a message.
- [Conversation](https://api-docs.tools.listrak.com/email/reference/conversation.md): The Conversation resource allows you to access conversations that have been created on a list.
- [ConversationSummary](https://api-docs.tools.listrak.com/email/reference/conversation-summary.md): The Conversation Summary resource allows you to access an aggregated summary of contact activity for a conversation.
- [ConversationMessageActivity](https://api-docs.tools.listrak.com/email/reference/conversation-message-activity.md): The Conversation Message Activity resource allows you to access contact activity for a message sent through a conversation.

## Other resources
- [Content](https://api-docs.tools.listrak.com/email/reference/content.md): The Content resource allows you to create and manage content blocks in the content library for a list.
- [ContentFolder](https://api-docs.tools.listrak.com/email/reference/content-folder.md): The Content Folder resource allows you to retrieve the folder hierarchy of the content library for a list.
- [ConversationMessage](https://api-docs.tools.listrak.com/email/reference/conversation-message.md): The Conversation Message resource allows you to access messages sent through a conversation.
- [ConversationMessageLink](https://api-docs.tools.listrak.com/email/reference/conversation-message-link.md): The Conversation Message Link resource allows you to access links for a message sent through a conversation.
- [ConversationMessageLinkClicker](https://api-docs.tools.listrak.com/email/reference/conversation-message-link-clicker.md): The Conversation Message Link Clicker resource allows you to access contacts that clicked a link in a message sent through a …
- [ConversationMessageSummary](https://api-docs.tools.listrak.com/email/reference/conversation-message-summary.md): The Conversation Message Summary resource allows you to access an aggregated summary of contact activity for a message sent …
- [Event](https://api-docs.tools.listrak.com/email/reference/event.md): An Event resource provides a way to access external events that have been created on a list.
- [EventGroup](https://api-docs.tools.listrak.com/email/reference/event-group.md): The EventGroup resource allows you to create containers which will contain and group events.
- [Folder](https://api-docs.tools.listrak.com/email/reference/folder.md): A Folder resource allows you to access the folders used to organize and group lists.
- [IpPool](https://api-docs.tools.listrak.com/email/reference/ip-pool.md): The IpPool resource exposes all of the IP Pools and their IDs for a user's Account.
- [MessageStatus](https://api-docs.tools.listrak.com/email/reference/message-status.md): The Message Summary resource allows you to access an aggregated summary of contact activity for a message.
- [SavedAudience](https://api-docs.tools.listrak.com/email/reference/saved-audience.md): The Saved Audience resource allows you to access saved audiences that have been created on a list.
- [SplitTest](https://api-docs.tools.listrak.com/email/reference/split-test.md): The SplitTest resource is used to retrieve information about automated email split tests.
- [TransactionalMessageActivity](https://api-docs.tools.listrak.com/email/reference/transactional-message-activity.md): The Transactional Message Activity resource allows you to access contact activity for a transactional message.
- [TransactionalMessageResend](https://api-docs.tools.listrak.com/email/reference/transactional-message-resend.md): The Transactional Message Resend resource allows you to resend a transactional message.

## Optional
- [Full reference (single file)](https://api-docs.tools.listrak.com/email/llms-full.txt): everything concatenated
- [OpenAPI spec](https://api-docs.tools.listrak.com/email/openapi.json): machine-readable Swagger 2.0