375 endpoints across 46 domains

Conduyt API Documentation

A CRM for you, your agents, and your AI team. Every feature is an API endpoint. Every endpoint is documented. Build, automate, and integrate with confidence.

Get API Key View llms.txt

Quick Start

Get your API key from Settings

Log in to your Conduyt account, go to Settings > API Keys, and create a new key. Use it as a Bearer token in all requests.

Discover all endpoints

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://conduyt.app/api/v1/schema/api-catalog

Explore workflow node types

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://conduyt.app/api/v1/automations/schema

Build, validate, and deploy

Use the validate endpoint before saving, dry-run before activating, and publish when ready. Every step is AI-friendly.

AI-First Features

Every feature is designed for programmatic access. AI agents are first-class citizens.

Workflow Builder API

Build entire multi-step automations programmatically. Define triggers, conditions, and actions in JSON.

Name Resolution

Use human-readable names like "Sales Pipeline" instead of UUIDs. The API resolves them for you.

Validation

Validate any workflow or automation graph before saving. Get precise error messages on what to fix.

Dry Run

Test automations against real data without side effects. See exactly what would happen.

Insights

8 query types for CRM health: pipeline health, SMS drip status, team activity, email performance, and more.

Smart Import

CSV upload + auto-tag + smart list enrollment + workflow enrollment in a single API call.

Agent Discovery

llms.txt, CLAUDE.md, and AGENTS.md ship with the repo. AI tools auto-discover capabilities without reading docs.

Scoped API Keys

Tier-based access (read/write/admin), domain scopes, IP allowlisting with CIDR, per-key rate limits.

For AI Agents

Three files ship with Conduyt so AI tools auto-discover what the CRM can do — no docs reading required.

llms.txtView file

Served at conduyt.app/llms.txt. Machine-readable discovery file — like robots.txt for AI. Lists capabilities, key endpoints, auth requirements, and getting-started steps. Any AI agent can fetch this to learn what Conduyt does before making API calls.

CLAUDE.mdrepo root

Project-level instructions for Claude Code (Anthropic's CLI). When a developer opens the Conduyt repo in Claude Code, it automatically reads this file and learns every API entry point, the tech stack, coding standards, and key file paths. Claude can then build workflows, create endpoints, and debug issues with full context.

AGENTS.mdrepo root

Same content as CLAUDE.md, formatted for Codex (OpenAI's coding agent) and other AI development tools. Identical API instructions ensure every AI assistant — regardless of provider — gets the same context when working on the codebase.

CLI

Manage your entire CRM from the terminal. Built for developers, agents, and automation pipelines.

Install

bash

npx -y @mvanhorn/printing-press install conduyt-crm

Requires Go 1.22+. Installs the CLI binary and a focused agent skill in one command.

Authenticate

bash

export CONDUYT_CRM_TOKEN="cdy_k1_your_api_key"
conduyt-crm-pp-cli doctor

Sync & Search Offline

bash

conduyt-crm-pp-cli sync
conduyt-crm-pp-cli contacts search "acme"

Mirror CRM data to local SQLite. Search, filter, and run analytics without hitting the API.

Pipeline Insights

bash

conduyt-crm-pp-cli insights pipeline-health
conduyt-crm-pp-cli insights deal-velocity --json

Compound analytics: stale deals, win rates, stage bottlenecks, email performance — all from synced data.

Agent Mode

Pass --agent to any command for JSON output, no prompts, and minimal token usage. The CLI also ships as an MCP server for direct integration with Claude, Codex, and other AI tools.

bash

conduyt-crm-pp-cli contacts list --agent --select id,firstName,email
conduyt-crm-pp-cli deals create --title "Acme Corp" --pipeline-id sales --agent

500+ endpoints. 30+ resource groups. One CLI.

Available on the Printing Press catalog.

View on Printing Press

API Reference

Browse all 375 endpoints by domain

Contacts

Loading API catalog...

Authentication

Bearer Token

All API requests require a Bearer token in the Authorization header. You can generate API keys from your account's Settings page.

bash

curl -H "Authorization: Bearer cdy_k1_a3b2c1d4..." \
  https://conduyt.app/api/v1/contacts

API Keys

Create keys with optional scopes and expiration dates. Revoke anytime from Settings.

Rate Limits

100 requests per 15 minutes per IP. Bulk endpoints have separate, higher limits.

Sessions

Browser sessions via cookie are also supported. Use API keys for programmatic access.

Example: Create a Contact

bash

curl -X POST https://conduyt.app/api/v1/contacts \
  -H "Authorization: Bearer cdy_k1_a3b2c1d4..." \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane@example.com",
    "phone": "+15551234567",
    "tags": ["new-lead"],
    "source": "api"
  }'

Example: Name Resolution for Automations

bash

curl -X POST https://conduyt.app/api/v1/automations/resolve \
  -H "Authorization: Bearer cdy_k1_a3b2c1d4..." \
  -H "Content-Type: application/json" \
  -d '{
    "tags": ["new-lead"],
    "pipelines": ["Sales Pipeline"],
    "users": ["John Doe"]
  }'

Returns UUIDs for each name. Use this so your AI agents never need to hardcode IDs.