# Listrak Cross Channel API

> REST API for publishing cross-channel events and managing event configurations.
> Base URL `https://api.listrak.com/crosschannel/v1`. Auth: OAuth2 client_credentials at `https://auth.listrak.com/OAuth2/Token` (Bearer token).
> 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/cross-channel/guides/getting-started.md): authenticate and post your first cross-channel event
- [Authentication (OAuth2)](https://api-docs.tools.listrak.com/cross-channel/guides/authentication.md): client_credentials flow; the spec's apiKey declaration is a gateway artifact
- [Errors & retries](https://api-docs.tools.listrak.com/cross-channel/guides/errors.md): HTTP status vs per-recipient statusCode - a 200 can still contain failures
- [PII & logging](https://api-docs.tools.listrak.com/cross-channel/guides/pii-logging.md): identifierValue and dataFields are PII; log eventUID and counts instead
- [Copy-paste client & recipes](https://api-docs.tools.listrak.com/cross-channel/guides/recipes.md): full Python + TypeScript client, schema discovery, batching events

## Other resources
- [Events](https://api-docs.tools.listrak.com/cross-channel/reference/events.md): REST endpoints to manage Custom Events.
- [EventConfigurations](https://api-docs.tools.listrak.com/cross-channel/reference/event-configurations.md): REST endpoints to manage Custom Event Configurations.

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