# Clozd

> Clozd is a decision-intelligence and win-loss analysis platform (Lehi, Utah). It collects structured buyer
> feedback through live human interviews, AI-assisted Flex interviews and autonomous Flow interviews, then
> turns it into decision drivers, competitor sentiment, win rates and verbatim buyer quotes for sales,
> marketing, product and customer-success teams. Two public programmatic surfaces: a versioned REST Data API
> (v1/v2/v3, OpenAPI 3.0.3, API-key auth) for importing CRM deals and exporting programs, deals, touchpoints,
> responses and transcripts; and a hosted OAuth 2.0 MCP server exposing 19 read tools over the same data.

Generated by API Evangelist from the public Clozd surface on 2026-08-04. Clozd does not publish its own
llms.txt (https://www.clozd.com/llms.txt returns 404).

Key facts an agent should know before calling anything:

- REST auth is an organization API token in the `x-api-token` header, created in the Clozd app Settings
  screen and shown only once. API access must first be enabled for the organization by a Clozd Program
  Manager or support@clozd.com — it is not self-serve.
- MCP auth is OAuth 2.0 authorization code + PKCE against https://oauth.clozd.com, brokered to the
  customer's own identity provider. No API keys go in client config.
- Every REST path is scoped under a program: call `get-programs-op` (`GET /programs`) first to get a
  `clozd_program_id`.
- Errors are a proprietary envelope — `{success:false, message, errorCode, data}` — not RFC 9457. Branch on
  `errorCode` (API003, API009, AUTH005, AUTH006, AUTH007, MCP001).
- Paging is `limit` (max 1000) + `offset` (max 100000) with absolute `links.next`.
- Nested data (feedback, transcripts, participants, products, tags, survey questions, custom fields) is only
  reachable via the `include` query parameter; there are no standalone collections for it.
- Imports are idempotent by natural key: re-importing a deal with the same `clozd_external_id` updates it
  rather than duplicating. A bad attribute rolls the whole import back.
- Incremental sync is poll-based via `filter[feedback_updated_since]` /
  `filter[competitor_updated_since]`. There are no webhooks and no event stream.
- No published rate limits, no status page, no changelog, no deprecation policy.

## APIs

- [Clozd Data API v3.0](https://app.clozd.com/public-api/docs/?urls.primaryName=v3.0): current version — 8
  operations across programs, competitors, deals and touchpoints. Base URL
  https://app.clozd.com/public-api/v3
- [Clozd Data API v2.0](https://app.clozd.com/public-api/docs/?urls.primaryName=v2.0): 3 operations — deal
  list, deal detail, deal import. Base URL https://app.clozd.com/public-api/v2
- [Clozd Data API v1.0](https://app.clozd.com/public-api/docs/?urls.primaryName=v1.0): 1 operation — deal +
  participant import. Base URL https://app.clozd.com/public-api/v1
- [Clozd MCP Server](https://help.clozd.com/hc/en-us/articles/49656607624987-Connecting-to-Clozd-via-MCP):
  https://mcp.clozd.com/mcp — 19 read-only tools. All three versions of the REST API are live simultaneously.

## Specs

- [OpenAPI v3.0 (live)](https://app.clozd.com/public-api/openapiv3.json)
- [OpenAPI v2.0 (live)](https://app.clozd.com/public-api/openapiv2.json)
- [OpenAPI v1.0 (live)](https://app.clozd.com/public-api/openapiv1.json)
- [OAuth 2.0 Authorization Server Metadata](https://oauth.clozd.com/.well-known/oauth-authorization-server)
- [OpenID Connect Discovery](https://oauth.clozd.com/.well-known/openid-configuration)
- [OAuth 2.0 Protected Resource Metadata (MCP)](https://mcp.clozd.com/.well-known/oauth-protected-resource/mcp)

## REST operations (v3.0)

- `get-programs-op` — GET /programs — list programs available to the token.
- `get-competitors-op` — GET /programs/{program_id}/competitors — competitors, optionally with deals and responses.
- `get-deals-op` — GET /programs/{program_id}/deals — paged deals.
- `get-deal-op` — GET /programs/{program_id}/deals/{deal_id} — one deal with participants, products, feedback, transcripts, tags, survey questions, custom fields.
- `post-deals-op` — POST /programs/{program_id}/deals — import deals and participants (upsert on clozd_external_id).
- `get-touchpoints-op` — GET /programs/{program_id}/touchpoints — paged touchpoints.
- `get-touchpoint-op` — GET /programs/{program_id}/touchpoints/{touchpoint_id} — one touchpoint with expansions.
- `post-touchpoints-op` — POST /programs/{program_id}/touchpoints — import touchpoints and participants.

## MCP tools

get_programs, get_deals, get_responses, get_response_summaries, get_transcripts, get_decision_drivers,
get_decision_driver_categories, get_decision_driver_category_counts, get_driver_quotes, get_win_rates,
get_competitors, get_competitor_sentiment_drivers, get_awe_deals, get_tags, get_gong_drivers,
get_gong_driver_categories, get_gong_driver_counts, get_gong_driver_category_counts, get_gong_driver_overlap

All are read-only. There is no MCP write tool — imports must go through the REST API.

## Docs

- [API Imports & Exports](https://help.clozd.com/hc/en-us/articles/9948957669659-API-Imports-Exports)
- [Connecting to Clozd via MCP](https://help.clozd.com/hc/en-us/articles/49656607624987-Connecting-to-Clozd-via-MCP)
- [Swagger UI (all three versions)](https://app.clozd.com/public-api/docs/)
- [Clozd MCP product page](https://www.clozd.com/product/platform/clozd-mcp)
- [Software integrations](https://www.clozd.com/product/platform/software-integrations)
- [Help center](https://help.clozd.com/hc/en-us)
- [Single Sign-On (SSO)](https://help.clozd.com/hc/en-us/articles/45409542002587-Single-Sign-On-SSO)

## Company

- [Website](https://www.clozd.com/)
- [Blog](https://www.clozd.com/blog)
- [Trust Center](https://trust.clozd.com) — ISO 27001, ISO 27701, SOC 2 Type II, audited annually
- [GDPR](https://www.clozd.com/privacy/gdpr)
- [Privacy Policy](https://www.clozd.com/privacy/policy)
- [Terms of Use](https://www.clozd.com/privacy/terms-of-use)
- [Log in](https://app.clozd.com/auth/login)
- [Talk with us](https://www.clozd.com/talk-with-us)
- Support: support@clozd.com · Privacy: privacy@clozd.com · Security: security@clozd.com

## API Evangelist artifacts

- authentication/clozd-authentication.yml
- conventions/clozd-conventions.yml
- errors/clozd-problem-types.yml
- lifecycle/clozd-lifecycle.yml
- data-model/clozd-data-model.yml
- conformance/clozd-conformance.yml
- scopes/clozd-scopes.yml
- mcp/clozd-mcp.yml
- mcp/clozd-tool-crosswalk.yml
- well-known/clozd-well-known.yml
- security/clozd-domain-security.yml
- security/clozd-trust-center.yml
- security/clozd-vulnerability-disclosure.yml
- skills/_index.yml