canonical: https://jentic.com/apis/breakcold.com/breakcold

# Breakcold Public API

The Breakcold API reads and writes CRM records across the workspaces a key is authorized to reach, and lets you search those records or create a new one from data your agent has gathered. Records cover the contacts, companies, and deals a sales team tracks in Breakcold. The surface is deliberately small: list your workspaces, search records, and create a record.

## For AI agents

List authorized workspaces, search CRM records, and create a new record in Breakcold from data an agent has collected.

## Scope

Does not handle email sending, call logging, or payment processing. Use for Breakcold CRM record search and creation only.

## Capabilities

- List the workspaces your bearer token is authorized to reach
- Search CRM records across contacts, companies, and deals
- Create a new CRM record from data your agent has gathered

## Use cases

### Agent-captured lead to CRM record

An AI agent that qualifies a prospect can create a Breakcold record directly, writing the contact or company straight into the workspace the sales team already works in. The agent first lists its authorized workspaces so it writes to the right one.

Example prompt: List authorized workspaces, then create a contact record for a lead named Dana Lee at acme.com in the sales workspace

### CRM record search

A support or sales agent can search Breakcold records to find an existing contact, company, or deal before acting, avoiding duplicate records. Search runs across the record types the workspace holds.

Example prompt: Search Breakcold records for a company named Acme and return the matching record

### Workspace-aware automation

An automation that serves several teams can list the workspaces its key is authorized for and route each new record to the correct one, so records never land in the wrong team workspace.

Example prompt: List the authorized workspaces and report which ones the current token can write records to

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/workspaces` | List authorized workspaces |
| GET | `/records` | List or search CRM records |
| POST | `/records` | Create a CRM record |

## Key resources

- **Workspaces** — List the workspaces the authenticated token may reach
- **Records** — Search CRM records and create a new contact, company, or deal record

## 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:** 69 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 88 / 100
  - AI-Readiness & Agent Experience: 48 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 63 / 100
- **View full report:** https://jentic.com/apis/breakcold.com/breakcold/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 Breakcold by hand means handling its bearer-token auth and figuring out which workspace a token may write to before you create anything. Through Jentic you install once, import Breakcold from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** You choose which Breakcold operations the agent may call, so you can allow workspace listing and record search while leaving record creation out until you add it.
- **Credential handling:** Your Breakcold token 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 record', and Jentic returns the matching Breakcold operation with its input schema so the agent writes to the right workspace without browsing the docs.

## Related APIs

- **Attio** — Attio is a flexible CRM with a rich data model; Breakcold keeps a small records surface.
- **Copper** — Copper is a Google Workspace CRM; Breakcold targets social-selling teams.
- **Salesforce** — Salesforce is a full enterprise CRM platform; Breakcold is a lightweight record API.
- **Apollo.io** — Apollo supplies prospect data; Breakcold stores the records a team acts on.

## FAQ

### What authentication does the Breakcold API use?

The Breakcold API authenticates with a bearer token in the Authorization header, per its OpenAPI spec. A token is tied to the workspaces it is authorized for, which you can list before writing any record.

### Is there a Breakcold MCP server?

Breakcold offers a hosted MCP server that exposes the same contract. You can also connect Breakcold directly through Jentic: your agent gets the record and workspace operations from the spec without loading another server's tool definitions into its context, your token is injected at call time by your self-hosted instance instead of living in a config file, and your rules decide which operations the agent may call.

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

Yes. Write a rule that allows only workspace listing and record search, so the agent can read your CRM but cannot create records until you add the create operation, and every call it makes is logged.

### Can I search CRM records with the Breakcold API?

Yes. The records endpoint lists or searches records across the contacts, companies, and deals a workspace holds, so an agent can look up an existing record before creating a duplicate.

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

The OpenAPI spec does not publish a numeric rate limit. Check the Breakcold API reference at https://docs.breakcold.com/api/overview for the current limits before running a high-volume job.

### How do I create a CRM record with the Breakcold API through Jentic?

Search Jentic for 'create a CRM record', and it returns the Breakcold create-record operation with its input schema. List your authorized workspaces first, then post the record to the right one. To run it on your own infrastructure, install Jentic One from its GitHub repo.