# Conduyt CRM — AI Agent Guide
# https://conduyt.app

> Conduyt is an AI-native CRM. Every feature is accessible to AI agents via REST API.
> "A CRM for you, your agents, and your AI team."

## API Base URL
https://conduyt.app/api/v1

## Getting Started
1. Authenticate with Bearer token
2. Call GET /api/v1/schema/api-catalog to discover all 356 endpoints across 30 domains
3. Call GET /api/v1/automations/schema for workflow node types and field definitions
4. Use POST /api/v1/automations/resolve to convert names to UUIDs

## Key Capabilities
- Build and deploy workflows programmatically (schema → validate → import → dry-run → publish)
- Import contacts with field mapping, tagging, smart lists, and workflow enrollment in one call
- Query CRM health: SMS drip status, untouched responses, agent follow-ups, pipeline health
- Manage users: create, invite, deactivate, reactivate, performance stats
- Full CRUD on: contacts, deals, pipelines, companies, tags, tasks, invoices, forms, calendars
- Email templates and sequences with test send
- SMS providers and drip campaigns
- Custom fields, smart views, smart lists, scoring rules
- Webhooks, Zapier integration, chat

## AI-Friendly Features
- Name-to-ID resolution: say "new-lead" not a UUID
- Stateless validation: check a workflow graph for errors before saving
- Dry-run: test workflows without side effects
- Sandbox mode: append ?dry_run=true to any mutation endpoint to preview results without persisting — the DB transaction rolls back, response includes _sandbox: true
- Insights API: 8 structured query types for reporting
- API catalog: machine-readable endpoint discovery
- Rate limit headers: every API response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- Confirmation tokens: destructive actions (delete, bulk delete, GDPR forget) require a confirmation token from POST /api/v1/confirm
- Action budget: API keys have a 500 mutations/hour budget, tracked via X-Action-Budget-Remaining header
- PII masking: audit log responses mask email, phone, SSN, and financial fields
- Deal smart views: saved deal filters at /api/v1/deals/views (same pattern as contact smart views)

## Authentication
All endpoints require: Authorization: Bearer <token>
API keys: Bearer cdy_... with tier-based scoping (read/write/admin), domain scopes, IP allowlisting
Public endpoints: booking pages, form submissions, webhook callbacks

## Documentation
- API Catalog: GET /api/v1/schema/api-catalog
- Workflow Schema: GET /api/v1/automations/schema
- Condition Fields: GET /api/v1/automations/condition-fields

## Contact
support@conduyt.app