# LDM Developers

> Email delivery API for AI agents. Documentation portal.

## Sections

- [LDM Developer API — UI = MCP](https://developers.live-direct-marketing.online/welcome.md): CRM + outbound email mailing as a Bearer-authenticated HTTP API. Same endpoint surface for the web UI and for AI agents — one place to call, one set of scopes to grant.
- [Quickstart](https://developers.live-direct-marketing.online/quickstart.md): Sign up, send a test message, and check delivery status — three calls, all verified.
- [Authentication](https://developers.live-direct-marketing.online/authentication.md): One endpoint surface, two auth schemes — Bearer for agents/MCP, Cookie/JWT for the UI.
- [API Registration](https://developers.live-direct-marketing.online/api-registration.md): How to register and obtain an API key for the LDM API.
- [Agent Card — LDM discovery](https://developers.live-direct-marketing.online/agent-card.md): Discovery endpoint for autonomous agents.
- [CRM — Companies & Contacts](https://developers.live-direct-marketing.online/crm-companies.md): Create, list, search and update companies and contacts via Bearer.
- [Leads & Pipelines](https://developers.live-direct-marketing.online/leads-pipeline.md): Manage sales pipelines, stages and leads end-to-end.
- [Mailing Campaign — agent self-approve](https://developers.live-direct-marketing.online/mailing-flow.md): Create email account → creative → mailing task → approve → start. Agent with mailing:write can approve its own task.
- [Anti-spam — suppression, stop-list, marking](https://developers.live-direct-marketing.online/anti-spam.md): Three independent layers: suppression (single emails), stop-list (whole domains/companies), marking patterns (regex on outbound bodies).
- [AI — providers and generation](https://developers.live-direct-marketing.online/ai-keys.md): Bring your own AI key (OpenAI, Anthropic, AItunnel, HydraAI, LDM-AI). Generate copy / replies on demand.
- [Dialogs — read inbox, reply, compose, search](https://developers.live-direct-marketing.online/dialogs.md): Full inbox surface for an autonomous agent: list, search, stats, threads, compose, reply, mark-read, share, attachments.
- [Tasks — mailing campaign lifecycle](https://developers.live-direct-marketing.online/tasks-campaigns.md): Beyond create — start, pause, stop, restart, plus per-task analytics and live monitor.
- [Custom fields — define and use](https://developers.live-direct-marketing.online/custom-fields.md): Per-tenant custom fields for COMPANY / CONTACT / LEAD / EMAIL_ACCOUNT entities. Read picker on each entity, write values, see them in exports.
- [Files — uploads, images, attachments](https://developers.live-direct-marketing.online/files.md): Upload a file, get its `fileId`, attach it to a dialog or use it as image asset.
- [Webhooks — event subscriptions](https://developers.live-direct-marketing.online/webhooks.md): Subscribe to lead/dialog/task events with HMAC-signed deliveries; inspect the delivery log; retry failed pushes.
- [Briefs & Creatives](https://developers.live-direct-marketing.online/briefs-creatives.md): A brief captures the ICP / value-prop; a creative is the email template (subject + bodyHtml) that uses spintax + variables.
- [Pipelines & stages — full CRUD](https://developers.live-direct-marketing.online/pipelines-stages.md): Create a pipeline (auto-seeds default stages), add/reorder/rename/hide stages, attach automations.
- [Activities — comments and history](https://developers.live-direct-marketing.online/activities.md): Add a NOTE / CALL / MEETING entry to a lead/contact/company. The same feed shows STAGE_CHANGE, LEAD_CREATED, etc. — system events stream into the same table.
- [Tags & saved views](https://developers.live-direct-marketing.online/tags-views.md): Lightweight cross-entity labels (tags) and saved filter sets (views) — for fast re-running of the same queries.
- [Imports — bulk load CSV](https://developers.live-direct-marketing.online/imports.md): Upload a CSV, preview the auto-mapping, kick off the import job, watch progress.
- [Connectors — external sources](https://developers.live-direct-marketing.online/connectors.md): Receive Tilda form submissions as inbound leads, look up Russian companies by name through DaData.
- [Best send time](https://developers.live-direct-marketing.online/best-send-time.md): Compute the optimal local send window for a recipient based on TZ + historical reply patterns.
- [Limits & Restrictions](https://developers.live-direct-marketing.online/limits.md): All limits enforced by the public API — rate, body size, password policy, quota, validation.
- [Errors](https://developers.live-direct-marketing.online/errors.md): Standard error response shape across all endpoints.

## Conventions

- Base URL: https://api.live-direct-marketing.online
- Auth: Bearer token in `Authorization` header.
- Status: closed beta.