Conduyt Lead Routing API
Lead assignment routing rules and assignment history
Lead assignment routing rules and assignment history
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-lead-routing-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 Lead Routing 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: Lead Routing
description: Lead assignment routing rules and assignment history
paths:
/lead-routing:
get:
operationId: listLeadRoutingRules
summary: List lead routing rules
tags:
- Lead Routing
responses:
'200':
description: Rules with assignees, stale assignee IDs, and available assignees
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
rules: {}
availableAssignees: {}
required:
- rules
- availableAssignees
required:
- data
parameters: []
post:
operationId: createLeadRoutingRule
summary: Create a lead routing rule
tags:
- Lead Routing
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
method:
default: round_robin
type: string
enum:
- round_robin
- up_for_grabs
- pull
isActive:
default: true
type: boolean
sourceFilter:
default: []
maxItems: 50
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
tagFilter:
default: []
maxItems: 50
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
territoryFilter:
default: []
maxItems: 100
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
assigneeIds:
default: []
maxItems: 100
type: array
items:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
assigneeGroupId:
anyOf:
- type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- type: 'null'
sortOrder:
default: 0
type: integer
minimum: 0
maximum: 9007199254740991
redistributeAfterDays:
anyOf:
- type: integer
minimum: 0
maximum: 3650
- type: 'null'
claimWindowMinutes:
anyOf:
- type: integer
minimum: 0
maximum: 10080
- type: 'null'
assigneeSelection:
default: round_robin
type: string
enum:
- round_robin
- performance
dailyLeadCap:
anyOf:
- type: integer
minimum: 0
maximum: 10000
- type: 'null'
shiftAware:
default: false
type: boolean
responses:
'201':
description: Lead routing rule created
content:
application/json:
schema:
$ref: '#/components/schemas/DataEnvelope'
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
/lead-routing/reorder:
patch:
operationId: reorderLeadRoutingRules
summary: Reorder lead routing rules
tags:
- Lead Routing
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- order
properties:
order:
type: array
items:
type: string
format: uuid
responses:
'200':
description: Rule order updated
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
success:
type: boolean
required:
- success
required:
- data
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
/lead-routing/test:
post:
operationId: testLeadRouting
summary: Simulate lead routing
tags:
- Lead Routing
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
contactId:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
source:
anyOf:
- type: string
maxLength: 120
- type: 'null'
tags:
default: []
maxItems: 50
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
description: 'Conditional request requirements: Provide contactId or source/tags to test routing. Flat requiredFields are intentionally omitted; read endpoint notes/description and validation errors for valid field combinations. Rules the route enforces: Provide contactId or source/tags to test routing Provide contactId, a non-empty source or at least one tag.'
responses:
'200':
description: Routing prediction
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
matched: {}
context: {}
prediction: {}
required:
- matched
- context
- prediction
required:
- data
parameters: []
/lead-routing/assignment-log:
get:
operationId: listLeadAssignmentLog
summary: List lead assignment history
tags:
- Lead Routing
parameters:
- name: assignedTo
in: query
required: false
description: Query parameter read by this route.
schema:
type: string
- name: contactId
in: query
required: false
description: Query parameter read by this route.
schema:
type: string
- name: page
in: query
required: false
description: Page number
schema:
type: integer
default: 1
minimum: 1
x-default-provenance: handler_literal
- name: per_page
in: query
required: false
description: Items per page (max 200)
schema:
type: integer
default: 25
minimum: 1
maximum: 100
x-default-provenance: handler_literal
- name: ruleId
in: query
required: false
description: Query parameter read by this route.
schema:
type: string
responses:
'200':
description: Visibility-scoped assignment log
content:
application/json:
schema:
type: object
properties:
data:
type: array
items: {}
meta:
type: object
properties:
page:
type: integer
perPage:
type: integer
total:
type: integer
totalPages:
type: integer
required:
- page
- perPage
- total
- totalPages
required:
- data
- meta
/lead-routing/{id}:
get:
operationId: getLeadRoutingRule
summary: Get a lead routing rule
tags:
- Lead Routing
parameters:
- $ref: '#/components/parameters/IdParam'
responses:
'200':
description: Lead routing rule
content:
application/json:
schema:
$ref: '#/components/schemas/DataEnvelope'
patch:
operationId: updateLeadRoutingRule
summary: Update a lead routing rule
tags:
- Lead Routing
parameters:
- $ref: '#/components/parameters/IdParam'
- 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: Lead routing rule updated
content:
application/json:
schema:
$ref: '#/components/schemas/DataEnvelope'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
method:
type: string
enum:
- round_robin
- up_for_grabs
- pull
isActive:
type: boolean
sourceFilter:
maxItems: 50
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
tagFilter:
maxItems: 50
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
territoryFilter:
maxItems: 100
type: array
items:
type: string
minLength: 1
maxLength: 120
description: Leading and trailing whitespace is trimmed before the length check, so a blank value is refused.
assigneeIds:
maxItems: 100
type: array
items:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
assigneeGroupId:
anyOf:
- type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- type: 'null'
sortOrder:
type: integer
minimum: 0
maximum: 9007199254740991
redistributeAfterDays:
anyOf:
- type: integer
minimum: 0
maximum: 3650
- type: 'null'
claimWindowMinutes:
anyOf:
- type: integer
minimum: 0
maximum: 10080
- type: 'null'
assigneeSelection:
type: string
enum:
- round_robin
- performance
dailyLeadCap:
anyOf:
- type: integer
minimum: 0
maximum: 10000
- type: 'null'
shiftAware:
type: boolean
delete:
operationId: deleteLeadRoutingRule
summary: Delete a lead routing rule
tags:
- Lead Routing
parameters:
- $ref: '#/components/parameters/IdParam'
- 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: Lead routing rule deleted
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id: {}
deleted:
type: boolean
required:
- id
- deleted
required:
- data
components:
schemas:
DataEnvelope:
type: object
properties:
data:
description: Response payload (shape varies by endpoint)
parameters:
IdParam:
name: id
in: path
required: true
schema:
type: string
format: uuid
description: Resource UUID
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