Conduyt Warmy Engine API
The Warmy Engine API from Conduyt — 3 operation(s) for warmy engine.
The Warmy Engine API from Conduyt — 3 operation(s) for warmy engine.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/conduyt-com:conduyt-com-warmy-engine-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Conduyt Warmy Engine API
version: 1.0.0
description: 'The Conduyt CRM API provides programmatic access to your CRM data including
contacts, companies, deals, pipelines, tasks, notes, automations, invoices,
email sequences, and more.
## Authentication
All authenticated endpoints require a Bearer token (API key) in the
`Authorization` header:
```
Authorization: Bearer cdy_
```
API keys are generated in **Settings > API Keys** within the Conduyt
dashboard. Keys use the `cdy_` prefix and are hashed with bcrypt on
creation — the full key is shown exactly once at creation time.
Session cookie authentication (`conduyt_session`) is also supported for
browser-based clients but is not recommended for integrations.
## Rate Limiting
API keys enforce a per-key rate limit. New keys default to 100 requests per
minute and can be configured at creation time or with PATCH `/api-keys/{id}`.
Some public and provider-facing endpoints also enforce stricter per-IP or
per-account limits. When exceeded, the API returns `429 Too Many Requests`
with a `Retry-After` header indicating seconds until the next allowed
request.
| Endpoint Group | Limit |
|---------------------|---------------------|
| API keys | Default 100 / min per key |
| Login/reset | 5 / min per IP |
| Registration | 3 / hour per IP |
| Contact/Deal create | 30 / min per IP |
| Inbound messages | 120 / min per account/IP |
## Pagination
List endpoints support cursor-based pagination via query parameters:
- `page` — Page number (default: 1)
- `per_page` — Items per page (default: 50, max: 200)
- `limit` — Accepted as an alias of `per_page` on `GET /contacts`; if both are
sent they must carry the same value.
A page size above the maximum, a non-integer, a value below 1, or a
pagination key repeated with different values is rejected with `400`
(the message names the parameter and the rule); nothing is silently
clamped or ignored.
Responses include a `meta` object: `{ page, per_page, total }`.
An operation that documents its own pagination rules follows those instead.
`GET /sms-providers/options` pages with an opaque `cursor` and a `limit`
that is capped at 50 rather than rejected; its responses carry
`meta: { nextCursor, truncated }`.
## Response Format
All successful responses wrap data in a `data` envelope:
```json
{ "data": { ... } }
```
Error responses use:
```json
{ "error": "Human-readable error message" }
```
## Multi-Tenancy
Conduyt is multi-tenant. All data is scoped to the authenticated user''s
current account. API keys are bound to a specific account at creation time.
## Webhook Events
Outbound webhooks fire on events including:
`contact.created`, `contact.updated`, `contact.deleted`,
`deal.created`, `deal.updated`, `deal.won`, `deal.lost`,
`task.created`, `task.completed`, `note.created`,
`appointment.created`, `appointment.updated`,
`form.submitted`, `invoice.paid`
Payloads are signed with HMAC-SHA256 using the webhook''s secret. Retry
schedule: 1m, 5m, 30m, 2h, 12h, 72h (7 total attempts including the initial delivery).'
contact:
name: Conduyt Support
url: https://conduyt.app
email: support@conduyt.app
license:
name: Proprietary
url: https://conduyt.app/terms
servers:
- url: https://conduyt.app/api/v1
description: Production
security:
- BearerAuth: []
tags:
- name: Warmy Engine
paths:
/warmy-engine/health:
get:
x-generated: true
operationId: getWarmyEngineHealth
summary: List warmy-engine health
tags:
- Warmy Engine
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
enabled: {}
warmupMode: {}
pool: {}
formatBreakdown: {}
recentActivity: {}
thresholds: {}
required:
- enabled
- warmupMode
- pool
- formatBreakdown
- recentActivity
- thresholds
required:
- data
/warmy-engine/sync:
post:
x-generated: true
operationId: postWarmyEngineSync
summary: Create / invoke warmy-engine sync
tags:
- Warmy Engine
parameters:
- name: dry_run
in: query
required: false
description: Validate the mutation without persisting changes.
schema:
type: boolean
- name: sandbox
in: query
required: false
description: Run the mutation in sandbox mode.
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
qualified: {}
disqualified: {}
unchanged: {}
poolHealth: {}
alerts: {}
warmupModeExited: {}
required:
- qualified
- disqualified
- unchanged
- poolHealth
- alerts
- warmupModeExited
required:
- data
/warmy-engine/templates:
post:
x-generated: true
operationId: postWarmyEngineTemplates
summary: Create / invoke warmy-engine templates
tags:
- Warmy Engine
parameters:
- name: dry_run
in: query
required: false
description: Validate the mutation without persisting changes.
schema:
type: boolean
- name: sandbox
in: query
required: false
description: Run the mutation in sandbox mode.
schema:
type: boolean
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- templates
- webhookSecret
properties:
accountSlug:
anyOf:
- type: string
- type: 'null'
accountId:
anyOf:
- type: string
pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
- type: 'null'
templates:
minItems: 1
maxItems: 20
type: array
items:
anyOf:
- type: object
properties:
body:
description: Read by the handler from the JSON body (the route declares no schema for its type).
bodyHtml:
description: Read by the handler from the JSON body (the route declares no schema for its type).
category:
description: Read by the handler from the JSON body (the route declares no schema for its type).
name:
description: Read by the handler from the JSON body (the route declares no schema for its type).
subject:
description: Read by the handler from the JSON body (the route declares no schema for its type).
templateFormat:
description: Read by the handler from the JSON body (the route declares no schema for its type).
description: Read by the handler from the JSON body (the route declares no schema for its type).
- {}
description: Each template the batch attempts (a name, a subject and a body) is { name, subject, body (text), bodyHtml, category (text or null), templateFormat (html, plain or null) } with no other key and no zero byte in a text field; otherwise a 400 naming the template. A template without a name, subject or body is skipped and reported in the results.
webhookSecret:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
created: {}
warmySynced: {}
results: {}
required:
- created
- warmySynced
- results
required:
- data
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'API key authentication. Generate keys in Settings > API Keys.
Keys use the `cdy_` prefix.
Example: `Authorization: Bearer cdy_a1b2c3d4e5f6...`
'
x-mcp:
transport:
- stdio
- http
orchestration: code
endpoint_tools: hidden