Build on Conduyt.
Ship faster.

Overview

Conduyt's API lets you programmatically manage contacts, deals, pipelines, tasks, and more. Build integrations, automate workflows, and extend your CRM with a REST API that mirrors every action available in the Conduyt web app.

The API uses standard HTTP verbs, returns JSON responses, and authenticates via Bearer tokens. If you can make HTTP requests, you can use Conduyt's API. No SDK required (though we publish official ones for Node.js and Python).

Authentication

All API requests require a Bearer token sent in the Authorization header. Tokens are scoped to a workspace and can be granted read-only, read-write, or admin permissions.

Creating an API Key

1. Navigate to Settings → API in your Conduyt workspace
2. Click Generate Key
3. Choose a scope: read, read-write, or admin
4. Copy the key immediately; it will only be shown once

All API keys are prefixed with cdy_ for easy identification in logs and config files. Workspace API keys do not expire. User-scoped tokens expire after 90 days of inactivity.

curl https://conduyt.app/api/v1/contacts \
  -H "Authorization: Bearer cdy_your_api_key_here" \
  -H "Content-Type: application/json"

# 200 OK

Base URL

All API requests are made to the following base URL:

https://conduyt.app/api/v1

All endpoints documented in this guide are relative to this base. For example, the contacts list endpoint is GET https://conduyt.app/api/v1/contacts.

Rate Limits

Rate limits are enforced per API key and vary by plan tier. When you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header indicating when you can retry.

Rate limit information is included in every response via these headers:

Accounts & Workspaces

Conduyt uses a multi-tenant architecture where all data is scoped to a workspace. Each workspace belongs to an account and is fully isolated: contacts, deals, pipelines, and settings in one workspace are invisible to another.

API keys are workspace-scoped. A single account can have multiple workspaces (e.g., one per department or region), each with its own API keys, pipelines, and team members.

Pagination

All list endpoints return paginated results. Conduyt uses page-based pagination with page and limit query parameters.

GET /api/v1/contacts?page=2&limit=25

# Response includes pagination metadata
{
  "data": [...],
  "meta": {
    "page": 2,
    "limit": 25,
    "total": 342,
    "totalPages": 14
  }
}

Filtering

Most list endpoints support filtering via query parameters. Filters are specific to each resource. See the API Reference for available filters per endpoint.

Common filter patterns:

• Exact match: ?status=active
• Search: ?search=sarah (searches across name, email, phone)
• Date range: ?created_after=2026-01-01&created_before=2026-03-31
• Relationship: ?assigned_to=uuid

Error Handling

All error responses follow a consistent JSON structure with a stable code enum, a human-readable message, and optional details for validation errors.

{
  "error": {
    "code": "validation_failed",
    "message": "The request body contains invalid fields.",
    "details": [
      {
        "field": "email",
        "message": "Must be a valid email address"
      }
    ]
  }
}

Webhooks

Webhooks let you receive real-time HTTP notifications when events occur in your workspace. Instead of polling the API, register a webhook URL and Conduyt will POST event payloads to it.

Signing & Verification

Every webhook request is signed with HMAC-SHA256 using your workspace's webhook secret. The signature is sent in the X-Conduyt-Signature header. Always verify signatures before processing webhooks.

import crypto from 'crypto';

function verifyWebhook(req, secret) {
  const signature = req.headers['x-conduyt-signature'];
  const computed = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(req.body))
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(computed)
  );
}

Retry Policy

If your endpoint returns a non-2xx status code, Conduyt retries with exponential backoff for up to 72 hours. After 72 hours of failures, the webhook is automatically disabled and you'll receive an email notification.

Available Events

• contact.created, contact.updated, contact.deleted
• deal.created, deal.updated, deal.stage_changed
• task.created, task.completed
• message.sent, message.received
• note.created
• pipeline.updated

See Webhooks API Reference for the full event catalog and payload schemas.

API Resources

Below is a summary of every resource available in the Conduyt API. Each links to its full endpoint documentation in the API Reference.

SDKs

Official SDKs wrap the REST API with typed methods, automatic pagination, and built-in retry logic. Any language with HTTP support works. The SDKs are a convenience, not a requirement.

import { Conduyt } from '@conduyt/sdk';

const client = new Conduyt({
  apiKey: process.env.CONDUYT_API_KEY,
});

// List contacts
const { data, meta } = await client.contacts.list({
  search: 'sarah',
  limit: 25,
});

// Create a deal
const deal = await client.deals.create({
  name: 'Acme Corp Renewal',
  value: 24000,
  pipelineId: 'pipe_abc123',
  stageId: 'stage_qualified',
});

// => "deal_01HX7Q5CA..."

from conduyt import Conduyt

client = Conduyt(api_key=os.environ["CONDUYT_API_KEY"])

# List contacts
contacts = client.contacts.list(search="sarah", limit=25)

# Create a deal
deal = client.deals.create(
    name="Acme Corp Renewal",
    value=24000,
    pipeline_id="pipe_abc123",
    stage_id="stage_qualified",
)

print(deal.id)
# => "deal_01HX7Q5CA..."

Both SDKs are open source. Contributions welcome.

• Node.js: github.com/conduyt/sdk-node · npm
• Python: github.com/conduyt/sdk-python · PyPI

Quickstart

Go from zero to your first API call in under 5 minutes.

1. Create an API key

   Go to Settings → API in your Conduyt workspace. Click Generate Key, select read-write scope, and copy the key. It starts with cdy_.

2. List your contacts

   Make your first API call to fetch contacts from your workspace.

   curl

   curl -s https://conduyt.app/api/v1/contacts?limit=5 \
     -H "Authorization: Bearer cdy_your_api_key" | jq .
   
   # Returns your first 5 contacts with pagination metadata

3. Create a deal

   Create a new deal in your default pipeline.

   curl

   curl -X POST https://conduyt.app/api/v1/deals \
     -H "Authorization: Bearer cdy_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Northwind Logistics",
       "value": 42000,
       "pipelineId": "pipe_default",
       "stageId": "stage_qualified"
     }'
   
   # Returns the newly created deal object

4. Set up a webhook

   Subscribe to deal events so you get notified when deals are created or updated.

   curl

   curl -X POST https://conduyt.app/api/v1/webhooks \
     -H "Authorization: Bearer cdy_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-app.com/webhooks/conduyt",
       "events": ["deal.created", "deal.stage_changed"],
       "active": true
     }'
   
   # Returns the webhook object with your signing secret

5. Next steps

   You're up and running. Explore the full API Reference for all available endpoints, or install an SDK for typed access in your language of choice.