# API and webhooks

> A REST API for leads, deals, contacts, companies, tasks and quotes, upsert by email, and signed webhooks for every CRM event. Easy for agents and Zapier.

URL: https://office.greatwork.company/crm/features/api-and-webhooks
Last updated: 2026-11-21

Read and write every record with an API key, and get a signed webhook for every event, so your other tools and agents stay in sync.

## The REST API

Create, read, update and delete leads, deals, contacts, companies and products with an API key (read or write scope). Add notes, tasks and calls to any record, convert leads, move deals between stages, mark them won or lost, and create quotes. Lists filter by status, owner, stage, source, email and "updated since", with cursor paging.

Two things make it easy to call from scripts and assistants: creating a lead runs the [duplicate check](/crm/features/duplicate-detection) and tells you whether it created or re-engaged, and contacts and leads can be upserted by email in one call.

## Webhooks for every event

Get a signed POST to your URL when leads are created, converted or re-engaged, deals change stage or are won or lost, tasks are completed, quotes are accepted or declined, invoices are paid, emails arrive and forms are submitted. Failed deliveries are retried.

## Zapier, Make and n8n

Use their webhook triggers with our events, and their HTTP actions with our API. An inbound webhook URL that creates leads from any tool without an API key is coming soon.

## Example: Logging calls from a phone system

A team's phone provider sends a webhook after each call. A 20-line script looks up the contact with `GET /contacts?email=...` and posts the call with `POST /calls` (duration, direction, outcome). When a deal is won, our `crm.deal.won` webhook tells their onboarding tool to start the client checklist.

## How to set it up

1. Create an API key in **Settings, API and webhooks** with read or write scope.
2. Add a webhook endpoint and pick the events it should receive.
3. Verify the signature header on each delivery.

## Questions

### Is the API on every plan?

Yes. Every plan has the API and webhooks, like every other feature.

### Is there an OpenAPI spec?

A published OpenAPI file for agents and code generators is coming soon.

---

Office by Great Work. Questions or corrections: hello@greatwork.company
