canonical: https://jentic.com/apis/conduyt.app/conduyt

# Conduyt App Conduyt API

The Conduyt API manages a full CRM over its contacts, companies, deals, pipelines, tasks, and notes, with email sequences, drip campaigns, automations, forms, calendars, and invoices layered on top. Contacts, companies, and deals are each addressed by id and support tagging, custom fields, and activity history. Many write operations accept an Idempotency-Key and a dry_run flag so a change can be previewed before it commits. Authentication uses a bearer API key with a cdy_ prefix.

## For AI agents

Create and update contacts, companies, and deals, move deals through pipelines, run email sequences and automations, and preview writes with a dry run through the Conduyt CRM.

## Scope

Does not handle payment processing, email delivery infrastructure, or data warehousing. Use for managing CRM contacts, companies, deals, and their follow-up only.

## Capabilities

- Create and update contacts with tags, custom fields, and activity history
- Track companies and the deals linked to them
- Move deals through pipeline stages on a board
- Run email sequences and drip campaigns against contacts
- Trigger automations and workflows on CRM records
- Preview a write with a dry run before it commits

## Use cases

### Agent-Managed CRM Updates

An AI agent connected through Jentic can keep the CRM current from a conversation or an inbound event: it creates a contact, creates a deal linked to that contact, and previews the deal update with a dry run before committing. The Idempotency-Key header lets the agent retry a create safely without producing duplicates.

Example prompt: Create a contact, create a deal linked to it, and preview the deal update with a dry run before committing

### Pipeline Reporting

Sales leaders need an up-to-date view of the pipeline. Conduyt lists deals filtered by stage and lists companies that have open deals, so an agent can assemble a stage-by-stage pipeline summary and flag the accounts with active opportunities without exporting the whole CRM.

Example prompt: List deals in the Negotiation stage and the companies that have open deals

### Outbound Sequencing

Conduyt carries email sequences and drip campaigns beside the CRM records, so follow-up runs from the same data. An agent enrolls a new contact in an email sequence and then reads the contact's activities to confirm the enrollment took, keeping outreach tied to the contact record.

Example prompt: Enroll a new contact in an email sequence and read the contact's activities to confirm it

### Safe Bulk Edits

Bulk changes to a CRM are risky, so Conduyt lets an agent rehearse them. Write operations accept a dry_run flag that returns the effect without persisting it, so an agent can validate a batch of contact updates first, then re-run with an Idempotency-Key to apply them exactly once.

Example prompt: Update a batch of contacts with a dry run first, then commit with an Idempotency-Key

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/contacts` | Create a contact |
| GET | `/contacts` | List contacts |
| POST | `/companies` | Create a company |
| GET | `/companies` | List companies |
| POST | `/deals` | Create a deal |
| GET | `/deals` | List deals |

## Key resources

- **Contacts** — Create, read, and update contacts with tags, custom fields, and activities
- **Companies** — Track companies, their intelligence, and the deals linked to them
- **Deals and Pipelines** — Move deals through pipeline stages and read deal activities
- **Email and Automations** — Run email sequences, drip campaigns, automations, and workflows

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 47 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 42 / 100
  - Developer Experience & Jentic Compatibility: 56 / 100
  - AI-Readiness & Agent Experience: 48 / 100
  - Agent Usability: 43 / 100
  - Security: 60 / 100
  - AI Discoverability: 42 / 100
- **View full report:** https://jentic.com/apis/conduyt.app/conduyt/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Conduyt by hand means handling its bearer cdy_ key, choosing between dry_run and committed writes, and setting an Idempotency-Key on creates across a very large surface. Through Jentic you install once, import Conduyt from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Conduyt puts record ids in the URL path (`/contacts/{id}`, `/deals/{id}`), so a rule can bound your agent to the operations you pick, such as reading contacts and deals, while create, update, and delete operations stay out unless you add them. Many writes also accept a dry_run flag so the agent can preview a change before it commits.
- **Credential handling:** Your Conduyt key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a CRM contact' or 'list deals in a pipeline', and Jentic returns the matching Conduyt operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **HubSpot CRM Contacts** — HubSpot is a large CRM platform with deep marketing and sales tooling.
- **Pipedrive** — Pipedrive is a sales-focused CRM centered on deal pipelines.
- **Close** — Close is a CRM built around calling and email for inside sales teams.
- **Twilio SendGrid Mail** — SendGrid sends high-volume transactional email that Conduyt sequences can hand off.

## FAQ

### What authentication does the Conduyt API use?

The Conduyt API authenticates with a bearer API key sent in the Authorization header, where keys carry a cdy_ prefix per its OpenAPI spec. When you call it through Jentic, that key is stored once by your own Jentic One instance and injected at execution time, so it never reaches the agent's prompt or logs.

### Can I filter deals by pipeline stage with the Conduyt API?

Yes. The list deals operation accepts filters including stage, assigned owner, and contact, and the list companies operation accepts a hasOpenDeals filter, so an agent can report the pipeline stage by stage and surface the accounts with active opportunities.

### What are the rate limits for the Conduyt API?

The OpenAPI spec does not define numeric rate limits for the Conduyt API. Check the Conduyt documentation at https://conduyt.app for the current request limits that apply to your API key.

### Can I limit what my agent is allowed to do with the Conduyt API?

Yes. Write a rule that allows only the contact and deal read operations, so the agent can list and inspect your CRM records but cannot create, update, or soft-delete them, and every call it makes is logged. For any writes you do enable, the dry_run flag lets the agent preview the change first.

### How do I create a contact with the Conduyt API through Jentic?

Search Jentic with an intent like 'create a CRM contact', and Jentic returns the create contact operation at /contacts with its input schema so your agent passes the contact fields and an Idempotency-Key. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Conduyt MCP server?

You don't need an MCP server to give your agent Conduyt. Jentic connects it directly from the API Directory: import the API, store your cdy_ key once, and your agent calls the contact, company, deal, and automation operations on demand.