Complete a task (tenant:crm:write)
POST /api/crm/v1/activities/{id}/complete
Module: CRM · operationId: completeActivity · Tag: Activities · Auth: access token (Authorization: Bearer <accessToken>)
Sets doneAt and doneBy. Only tasks (409, activity_not_task). Emits crm.task.completed.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes | Record ID (UUID). |
Responses
- 200 The completed task (
application/json) - 401 Missing, invalid or expired token (no body).
- 403 The token lacks the permission (
insufficient permissions) or has no active tenant. (application/json) - 404 The record does not exist in the token's tenant. (
application/json) - 409 The state of the record (or the tenant's settings) does not allow the request;
codesays why. (application/json) - 500 Unexpected error; details are only logged. (
application/json)
Fields of the 200 answer:
bookedMinutes(integer, nullable, required, read-only): Work HR booked on the activity (subjectcrm:activity:<id>, worked minus breaks, ADR 0040); filled byGET /activities/{id}and the activity list, null there when HR does not answer (never an error) and in answers of writes.createdAt(string (date-time), required): Creation time.customerNo(string, required): Customer number of the tenant.id(string (uuid), required): Id of the activity.kind(ActivityKind, required):SYSTEMentries are history written by the CRM and cannot be created or changed. (one ofNOTE,CALL,MEETING,EMAIL,TASK,SYSTEM)meta(object, required): Details ofSYSTEMentries (for example the old and new stage); of a tracked interactioninteractionId,provider,summaryandtranscript(left out by lists); empty otherwise.subject(string, required): Subject (one line).tenantName(string, required): Tenant name.updatedAt(string (date-time), required): Time of the last change.addressId(string (uuid)): Masterdata address the activity belongs to; omitted when not set.assigneeEmail(string): Employee the task is assigned to.body(string): Omitted when not set (and after anonymisation).campaignId(string (uuid)): Campaign the activity belongs to; omitted when not set.createdBy(string): E-mail of the creating person; omitted for system entries.createdByName(string): Name of the creating person; omitted when not known.doneAt(string (date-time), read-only): Completion time of a task.doneBy(string, read-only): Who completed the task.dueAt(string (date-time)): Due date of a task.interactionId(string (uuid), read-only): The comms interaction a tracked call or meeting records.leadId(string (uuid)): Lead the activity belongs to; omitted when not set.opportunityId(string (uuid)): Opportunity the activity belongs to; omitted when not set.recordName(string, read-only): Title of the opportunity, else company of the lead the activity belongs to; set by the activity list only.
Example 200 answer:
{
"assigneeEmail": "lena.vogel@muster-it.example",
"body": "Frau Gaßner wollte die Freigabe des Budgets mit dem Gesellschafter klären.",
"bookedMinutes": 25,
"createdAt": "2026-11-12T16:45:00Z",
"createdBy": "lena.vogel@muster-it.example",
"createdByName": "Lena Vogel",
"customerNo": "99999",
"dueAt": "2026-11-20T09:00:00Z",
"id": "1d3f5b7d-9e1a-4c3d-8f5b-9a1c3e5b7d9f",
"kind": "TASK",
"leadId": "5b7d9f1a-3c5e-4a7b-9d1f-3a5c7e9b1d3f",
"meta": {},
"opportunityId": "7d9f1b3d-5e7a-4c9b-8f1d-5c7e9a1b3d5f",
"recordName": "WLAN Sudhaus und Lager",
"subject": "Angebot WLAN Sudhaus nachfassen",
"tenantName": "DEMO",
"updatedAt": "2026-11-12T16:45:00Z"
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/crm/v1/activities/3f2b8c1e-6d4a-4f7b-9a2e-1c5d7e9f0a12/complete' \
-H "Authorization: Bearer $ACCESS_TOKEN"