# Live Direct Marketing Campaigns API

**Canonical:** https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-campaigns-api/  
**Provider:** Live Direct Marketing — https://apis.io/providers/live-direct-marketing-online/  
**Base URL:** https://api.live-direct-marketing.online  
**Documentation:** https://developers.live-direct-marketing.online/

Live Direct Marketing Campaigns API is one of 150 APIs that [Live Direct Marketing](https://apis.io/providers/live-direct-marketing-online/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Campaigns. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

The Campaigns API from Live Direct Marketing — 38 operation(s) for campaigns.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/campaigns/{id}/test-task` | Campaigns controller create test task |
| GET | `/api/campaigns/{id}/test-task/{taskId}` | Campaigns controller get test task |
| GET | `/api/campaigns/conveyor-health` | Campaign conveyor health for this tenant (#347), read-only. |
| GET | `/api/campaigns` | List campaigns |
| POST | `/api/campaigns` | Create a campaign. |
| POST | `/api/campaigns/backfill-historic-unsubscribes` | One-off backfill: mark campaign_recipients as UNSUBSCRIBED for addresses… |
| GET | `/api/campaigns/overview` | Campaigns overview for dashboard mailings widget |
| GET | `/api/campaigns/{id}` | Get a campaign by id |
| PATCH | `/api/campaigns/{id}` | Update a campaign (creative pool, routing, status and campaign-owned… |
| DELETE | `/api/campaigns/{id}` | Delete a campaign (cascades recipients; ACTIVE must be paused first) |
| GET | `/api/campaigns/{id}/geo-risk` | Geo channel-policy risk breakdown of recipients (read-only WARN report) |
| GET | `/api/campaigns/{id}/metrics` | Campaign metrics. |
| GET | `/api/campaigns/{id}/send-series` | Sending speed time series. |
| GET | `/api/campaigns/{id}/send-readiness` | Dry-run all send gates for a campaign: status, breaker, campaign-owned send… |
| GET | `/api/campaigns/{id}/operational-status` | Single source of truth for "what is happening with this campaign right now". |
| GET | `/api/campaigns/{id}/task-history` | Paginated durable delivery-task history for a campaign |
| GET | `/api/campaigns/{id}/hard-report` | Deterministic read-only quality snapshot for a campaign (#1245, first slice… |
| GET | `/api/campaigns/{id}/activity` | Unified chronological event feed for a campaign: the full recipient lifecycle… |
| GET | `/api/campaigns/{id}/recipients` | List campaign recipients. |
| POST | `/api/campaigns/{id}/recipients/move-stage` | Move campaign recipients to a canvas stage (no send) |
| POST | `/api/campaigns/{id}/recipients/rerender` | Reset unsent recipients back to SCREENED for a fresh re-render; force:true also… |
| POST | `/api/campaigns/{id}/recipients/repair-unsubscribe` | Backfill missing unsubscribe block and reconcile bodyHash for already-rendered… |
| POST | `/api/campaigns/{id}/retry-ai-failures` | Retry unsent AI failures with the current tenant provider/model — reset=0 is an… |
| POST | `/api/campaigns/{id}/reconcile-from-dialogs` | One-time: reconcile campaign recipients from existing dialogs (migration) |
| POST | `/api/campaigns/{id}/pour` | Pour recipients into a campaign. |
| POST | `/api/campaigns/{id}/push` | Push contacts directly into campaign (API-push, e.g. from form webhook) |
| POST | `/api/campaigns/{id}/pour-from-leads` | Pour recipients into a campaign from CRM leads by filter… |
| POST | `/api/campaigns/{id}/screen` | Screening of NEW recipients (suppression + stop-list): NEW→SCREENED\|SKIPPED. |
| POST | `/api/campaigns/{id}/recipients/content` | Submit self-rendered (BYOC) email content for SCREENED recipients… |
| PATCH | `/api/campaigns/{id}/recipients/{rid}/manual` | Manual edit of a job by an operator: subject/body/scheduledAt/stage. |
| GET | `/api/campaigns/{id}/recipients/{recipientId}/attachment-link` | Refresh a signed link to a recipient personal PDF without regeneration. |
| POST | `/api/campaigns/{id}/preparations` | Start or join a durable bounded preparation operation (no sending). |
| GET | `/api/campaigns/{id}/preparations/{generationId}` | Read a tenant-bound preparation operation. |
| POST | `/api/campaigns/{id}/prepare` | Prepare and audit a bounded window of provider-eligible recipients. |
| POST | `/api/campaigns/{id}/dispatch` | Assign sender account + schedule to READY recipients (no send yet). |
| POST | `/api/campaigns/{id}/send` | Hand dispatched READY recipients to the mail_outbox queue (limit=1 for first… |
| POST | `/api/campaigns/{id}/sync-events` | Sync open/click/bounce events from Dialog records back to recipients. |
| POST | `/api/campaigns/{id}/restore-infra-failed` | Resume a PAUSED campaign (reset circuit breaker) — also retries AI failures |
| POST | `/api/campaigns/{id}/resume` | Campaigns controller resume |
| POST | `/api/campaigns/{id}/pause` | Pause an ACTIVE campaign (symmetric to /resume) |
| GET | `/api/campaigns/{id}/recipients/{rid}` | Get a recipient with its event log. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/openapi/live-direct-marketing-online-campaigns-api-openapi.yml
- **Documentation** — https://developers.live-direct-marketing.online/
- **APIReference** — https://developers.live-direct-marketing.online/api-reference
- **GettingStarted** — https://developers.live-direct-marketing.online/quickstart
- **Authentication** — https://developers.live-direct-marketing.online/authentication
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/data-model/live-direct-marketing-online-data-model.yml
- **Documentation** — https://check.live-direct-marketing.online/docs
- **APIReference** — https://check.live-direct-marketing.online/api/docs

## Other Live Direct Marketing APIs (12)

- [LDM MCP Server](https://apis.io/apis/live-direct-marketing-online/ldm-mcp-server/)
- [LDM.delivery A2A Agent](https://apis.io/apis/live-direct-marketing-online/ldm-a2a-agent/)
- [LDM Webhook Events](https://apis.io/apis/live-direct-marketing-online/ldm-webhook-events/)
- [Inbox Check MCP Server](https://apis.io/apis/live-direct-marketing-online/inbox-check-mcp-server/)
- [Inbox Check A2A Agent Card](https://apis.io/apis/live-direct-marketing-online/inbox-check-a2a-agent/)
- [Live Direct Marketing A2A API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-a2a-api/)
- [Live Direct Marketing Account API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-account-api/)
- [Live Direct Marketing Activities API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-activities-api/)
- [Live Direct Marketing Admin API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-admin-api/)
- [Live Direct Marketing Admin / Honeypot API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-admin-honeypot-api/)
- [Live Direct Marketing Admin RPA API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-admin-rpa-api/)
- [Live Direct Marketing Agency API](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-agency-api/)

## Tags

Campaigns

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/live-direct-marketing-online/live-direct-marketing-online-campaigns-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/live-direct-marketing-online/.