Notes & Tasks
Attach freeform notes to a contact, company, deal, lead, quote or invoice, and track follow-up work with due dates, assignees and an overdue flag.
Overview
Notes are freeform text attached to a contact, company, deal, lead, quote or invoice. Tasks are the work someone still has to do — with a title, an optional due date, an assignee and an optional link to a record.
Both show up in the timeline for the record they attach to.
Authentication
Authorization: Bearer cm_your_api_key| Operation | Scope |
|---|---|
| Read notes | crm_notes:read |
| Write notes | crm_notes:write |
| Read tasks | crm_tasks:read |
| Write tasks | crm_tasks:write |
Notes
The note object
{
"id": "aa22…",
"tenant_id": "a0b1…",
"entity_type": "company",
"entity_id": "5c6d…",
"body": "Renewal call went well — wants a Hindi voice agent.",
"author_user_id": "b1f2…",
"created_at": "2026-08-16T12:00:00Z",
"updated_at": "2026-08-16T12:00:00Z"
}author_user_id is the dashboard user who wrote it, and is null when the note was created with an API key — a key is not a person.
GET/api/v1/crm/notes
Newest first. Both entity parameters are required — notes are always read in the context of one record.
| Parameter | Type | Required | Constraints |
|---|---|---|---|
entity_type | string | Yes | contact, company, deal, lead, quote or invoice |
entity_id | UUID | Yes | An unknown id returns an empty list |
limit | integer | No | 1 <= limit <= 200, default 50 |
offset | integer | No | 0 <= offset <= 100000, default 0 |
curl "https://api.callmissed.com/api/v1/crm/notes?entity_type=company&entity_id=5c6d…" \
-H "Authorization: Bearer cm_your_api_key"POST/api/v1/crm/notes
| Field | Type | Required | Constraints |
|---|---|---|---|
entity_type | string | Yes | contact, company, deal, lead, quote or invoice |
entity_id | UUID | Yes | Must exist in your tenant |
body | string | Yes | 1–10,000 characters, not blank |
curl -X POST https://api.callmissed.com/api/v1/crm/notes \
-H "Authorization: Bearer cm_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "entity_type": "company", "entity_id": "5c6d…", "body": "Renewal call went well." }'Returns 201. 404 Company not found (or Contact / Deal) when the target is not yours.
PATCHDELETE/api/v1/crm/notes/{note_id}
PATCH edits body only — a note cannot be re-pointed at a different record, so the audit trail stays honest. DELETE returns 204.
Notes are read one record at a time, so there is no updated_after here. To follow notes across your whole account, subscribe a webhook to note.created, note.updated and note.deleted.
Tasks
The task object
{
"id": "bb33…",
"tenant_id": "a0b1…",
"title": "Send the renewal quote",
"description": "Include the Hindi voice add-on.",
"status": "open",
"due_at": "2026-08-19T10:00:00Z",
"completed_at": null,
"assignee_user_id": "b1f2…",
"entity_type": "company",
"entity_id": "5c6d…",
"created_by_user_id": "b1f2…",
"created_at": "2026-08-16T12:05:00Z",
"updated_at": "2026-08-16T12:05:00Z",
"is_overdue": false
}| Field | Type | Notes |
|---|---|---|
status | string | open or done |
completed_at | datetime | null | Server-managed — not accepted on create or update. Set when status becomes done, cleared when it returns to open |
created_by_user_id | UUID | null | The dashboard user who created it; null when created with an API key |
is_overdue | boolean | Computed: due_at is in the past and status is open. A done task is never overdue |
GET/api/v1/crm/tasks
Ordered by due_at ascending with undated tasks last, then newest first — so the list reads as a work queue.
| Parameter | Type | Constraints |
|---|---|---|
status | string | open or done |
assignee_user_id | UUID | One person's queue |
entity_type | string | contact, company, deal, lead, quote or invoice |
entity_id | UUID | |
overdue | boolean | |
due_before | datetime | |
due_after | datetime | |
updated_after | datetime | ISO 8601, e.g. 2026-11-17T06:30:00Z (no offset is read as UTC). Only records whose updated_at is later than this. The result is then ordered oldest change first (updated_at ascending, then id) and sort is ignored. See incremental sync |
limit | integer | 1 <= limit <= 200, default 50 |
offset | integer | 0 <= offset <= 100000, default 0 |
curl "https://api.callmissed.com/api/v1/crm/tasks?status=open&overdue=true" \
-H "Authorization: Bearer cm_your_api_key"
# Tasks changed since your last sync, oldest change first
curl "https://api.callmissed.com/api/v1/crm/tasks?updated_after=2026-11-17T06:30:00Z&limit=200" \
-H "Authorization: Bearer cm_your_api_key"Returns an array of task objects. A deleted task is not in the list; deletions reach you only as the task.deleted webhook.
POST/api/v1/crm/tasks
| Field | Type | Required | Constraints |
|---|---|---|---|
title | string | Yes | 1–255 characters, not blank |
description | string | No | At most 10,000 characters |
status | string | No | open (default) or done |
due_at | datetime | No | |
assignee_user_id | UUID | No | Must be a user in your tenant |
entity_type | string | No | contact, company, deal, lead, quote or invoice |
entity_id | UUID | No | Must exist in your tenant |
curl -X POST https://api.callmissed.com/api/v1/crm/tasks \
-H "Authorization: Bearer cm_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"title": "Send the renewal quote",
"due_at": "2026-08-19T10:00:00Z",
"entity_type": "company",
"entity_id": "5c6d…"
}'entity_type and entity_id must be sent together — one without the other returns 422 entity_type and entity_id must be sent together. A task with neither is a standalone to-do.
A linked record outside your tenant returns 422 <entity_type> not found in this tenant; an assignee outside your tenant returns 422 assignee_user_id is not a user of this tenant. Returns 201.
PATCH/api/v1/crm/tasks/{task_id}
Same fields, all optional. The entity link is validated against the merged result, so you can move a task from a contact to a company in one call without tripping the pairing rule.
POST/api/v1/crm/tasks/{task_id}/complete
No body. Marks the task done and stamps completed_at.
Idempotent — completing an already-done task returns it unchanged. Safe to retry.
GETDELETE/api/v1/crm/tasks/{task_id}
DELETE returns 204. 404 Task not found.
Webhooks
Subscribe a webhook to note.created, note.updated, note.deleted, task.created, task.updated and task.deleted (an API key needs crm_notes:read for the note events and crm_tasks:read for the task events to subscribe). Completing a task sends task.updated. Created and updated events carry the note or task object above; a deleted event carries only id. Notes and tasks that are removed or moved because their parent record was deleted, merged or converted do not send their own events.
Errors
| Status | When |
|---|---|
403 | Key is missing the matching crm_notes:* / crm_tasks:* scope |
404 | Note or task not in your tenant, or (notes only) the record you attach a note to |
422 | Blank body/title, an updated_after that is not a date-time, unknown entity_type or status, an entity pair sent half-filled, a task's linked record or assignee outside your tenant |
Nothing on this page consumes credits.