# Harmony Public API

> REST API for importing, updating and reading contacts and listing workflows in a Harmony Account. Authenticate with a harmony_pk_ API key as a Bearer token. Also covers connecting AI tools through the MCP server at /api/mcp, and setting up the monday.com integration.

Every endpoint, parameter and response schema is in the OpenAPI spec: https://docs.harmony.ai/openapi.json

## Table of Contents

- [Introduction](https://docs.harmony.ai/docs.md): The Harmony Public API lets your own code push contacts into Harmony, update them, and read them back.
- [Quickstart](https://docs.harmony.ai/quickstart.md): This guide lists your workflows, then imports two contacts into one of them.
- [Authentication](https://docs.harmony.ai/authentication.md): Every request carries an API key as a bearer token:
- [Errors](https://docs.harmony.ai/errors.md): Every error response has the same JSON body:
- [Versioning](https://docs.harmony.ai/versioning.md): The major version is part of every path: `/api/v1/...`.
- [Environments](https://docs.harmony.ai/environments.md): Use the host that matches the region your Account lives in. Keys work only in the environment where they were created.
- [AI tools (MCP)](https://docs.harmony.ai/mcp/overview.md): Connect an AI assistant such as Claude Code, Codex, Cursor, or VS Code to Harmony, then ask about your contacts, calls, transcripts, and workflows ...
- [Claude Code](https://docs.harmony.ai/mcp/claude-code.md): Connect Claude Code to Harmony's MCP server with an API key.
- [Codex](https://docs.harmony.ai/mcp/codex.md): Connect Codex to Harmony's MCP server with an API key.
- [Cursor](https://docs.harmony.ai/mcp/cursor.md): Connect Cursor to Harmony's MCP server with an API key.
- [VS Code](https://docs.harmony.ai/mcp/vs-code.md): Connect VS Code to Harmony's MCP server with an API key.
- [Claude and Claude Desktop](https://docs.harmony.ai/mcp/claude.md): Connect Claude and Claude Desktop to Harmony's MCP server through a custom connector with a request header.
- [Tools and details](https://docs.harmony.ai/mcp/details.md): Each MCP tool calls one Public API operation as the user who created your API key, so it returns the same data and follows the same rules as the RE...
- [monday.com](https://docs.harmony.ai/integrations/monday/overview.md): Connect a monday.com board to Harmony to call the contacts on it. A monday automation enrolls an item into a Harmony workflow, Harmony places the c...
- [Enroll contacts](https://docs.harmony.ai/integrations/monday/enroll-contacts.md): A monday automation enrolls a board item into a Harmony workflow. Harmony then calls the contact on that workflow's schedule.
- [Fill timezone from phone](https://docs.harmony.ai/integrations/monday/timezone-from-phone.md): This optional Code block fills the contact's Timezone column from their phone number before enrollment. It keeps any timezone that is already set.
- [Update status after a call](https://docs.harmony.ai/integrations/monday/update-status.md): This monday automation sets the contact's Status from the result of each Harmony call, such as Busy or Meeting booked.
- [Log transcript and summary](https://docs.harmony.ai/integrations/monday/transcript-summary.md): This monday automation adds a subitem to the contact's item after each Harmony call. The subitem's update holds an AI summary, the call details, an...
- [When a Harmony call ends](https://docs.harmony.ai/integrations/monday/call-ended-trigger.md): This monday trigger runs after each Harmony call to a contact enrolled from monday. It doesn't run when the contact's item has left the trigger's b...