# Comarketing API

> List Preferred Partners, send a lead, read the leads you sent, and register a webhook.

## Docs

- [Comarketing API](https://www.comarketing.com/docs): List Preferred Partners, send a lead, read the leads you sent, and register a webhook.
- [Authentication](https://www.comarketing.com/docs/authentication): Send the account key from Integrations on every request.
- [Errors](https://www.comarketing.com/docs/errors): Status codes shared by every route. Error bodies are a single message.
- [Idempotency](https://www.comarketing.com/docs/idempotency): Make a retried send return the original lead for 24 hours.
- [Webhooks](https://www.comarketing.com/docs/webhooks): Verify the signature, then handle lead events at least once.

## Reference

- [Comarketing API](https://www.comarketing.com/docs/reference): List Preferred Partners, send a lead, read the leads you sent, and register a webhook.

### Partners

- [List Preferred Partners](https://www.comarketing.com/docs/reference/partners/list-partners): Active Preferred Partner agreements for the account that owns the key. Reference for the GET /api/partners endpoint in the Comarketing API.

### Leads

- [Send a lead](https://www.comarketing.com/docs/reference/leads/create-lead): Creates one lead for one Preferred Partner. 201 when this call inserts the row, whether… Reference for the POST /api/leads endpoint in the Comarketing API.
- [List leads you sent](https://www.comarketing.com/docs/reference/leads/list-leads): Leads in the key holder's Leads Sent scope. The account sees agreements it holds. A parent… Reference for the GET /api/leads endpoint in the Comarketing API.
- [Read a lead you sent](https://www.comarketing.com/docs/reference/leads/get-lead): One lead in the same scope as the list. Out of scope, unknown, or already declined is… Reference for the GET /api/leads/{id} endpoint in the Comarketing API.

### Webhooks

- [Register a webhook](https://www.comarketing.com/docs/reference/webhooks/register-webhook): Registers the URL that receives lead events. The URL must be https. Reference for the PUT /api/webhooks endpoint in the Comarketing API.
- [lead.delivered](https://www.comarketing.com/docs/reference/webhooks/lead-delivered): Sent when a queued lead is accepted. A retry posts the same id. Reference for the POST lead.delivered webhook in the Comarketing API.
- [lead.status_changed](https://www.comarketing.com/docs/reference/webhooks/lead-status-changed): Sent when a lead's status changes. Stored status completed is sent as won. A retry… Reference for the POST lead.status_changed webhook in the Comarketing API.
- [lead.declined](https://www.comarketing.com/docs/reference/webhooks/lead-declined): Sent when a queued lead is declined. This event has no status. A retry posts the same id. Reference for the POST lead.declined webhook in the Comarketing API.

## Agent skills

- [comarketing-api](https://www.comarketing.com/docs/.well-known/agent-skills/comarketing-api/SKILL.md): Read the Comarketing API docs instead of answering from memory. List Preferred Partners, send a lead, read the leads you sent, and register a webhook. Use when a task involves Comarketing API: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://www.comarketing.com/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://www.comarketing.com/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://www.comarketing.com/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://www.comarketing.com/docs/openapi.json.
- [Agent skills](https://www.comarketing.com/docs/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://www.comarketing.com/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://www.comarketing.com/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://www.comarketing.com/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://www.comarketing.com/docs/sitemap.xml): Every indexable page URL with its last-modified date.