Create an activity (tenant:crm:write)
POST /api/crm/v1/activities
Module: CRM · operationId: createActivity · Tag: Activities · Auth: access token (Authorization: Bearer <accessToken>)
At least one of leadId, opportunityId and addressId is required (400,
activity_link_required); the records must exist in the tenant. The creating person is stored
as createdBy. Engagement activities change the score of the lead when lead scoring is on. An activity of an
anonymised lead is 409 (lead_anonymized).
Emits crm.activity.created (and crm.task.assigned for a task with an assignee).
Request body
application/json (required)
kind(string, required): Kind of the activity (SYSTEMcannot be created). (one ofNOTE,CALL,MEETING,EMAIL,TASK)subject(string, required): Subject (one line). (max length 255)addressId(string (uuid)): A masterdata address of the tenant (422otherwise).assigneeEmail(string (email)): Employee a task is assigned to. (max length 255)body(string): Text of the activity. (max length 20000)dueAt(string (date-time)): Due date of a task.leadId(string (uuid)): A lead of the tenant (422otherwise).opportunityId(string (uuid)): An opportunity of the tenant (422otherwise).
Example:
{
"assigneeEmail": "vertrieb@example.com",
"dueAt": "2026-12-01T09:00:00Z",
"kind": "TASK",
"leadId": "3f2b8c1e-6d4a-4f7b-9a2e-1c5d7e9f0a12",
"subject": "Angebot nachfassen"
}
Responses
- 201 Created (
application/json) - 400 Invalid input (
invalid):fieldnames the first invalid field,details.fieldsevery one (JSON paths for bodies, parameter names for the query). Some refusals have their own code (invalid_sort,invalid_stages,invalid_custom_fields,convert_target_required,invalid_csv, …). (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) - 422 A referenced record (lead, masterdata address) does not exist in the tenant. (
application/json) - 500 Unexpected error; details are only logged. (
application/json)
Fields of the 201 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 201 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' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"assigneeEmail":"vertrieb@example.com","dueAt":"2026-12-01T09:00:00Z","kind":"TASK","leadId":"3f2b8c1e-6d4a-4f7b-9a2e-1c5d7e9f0a12","subject":"Angebot nachfassen"}'