ConnectCloud Developers

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; code says 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 (subject crm:activity:<id>, worked minus breaks, ADR 0040); filled by GET /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): SYSTEM entries are history written by the CRM and cannot be created or changed. (one of NOTE, CALL, MEETING, EMAIL, TASK, SYSTEM)
  • meta (object, required): Details of SYSTEM entries (for example the old and new stage); of a tracked interaction interactionId, provider, summary and transcript (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"

View as Markdown · Interactive reference · OpenAPI