creatorId is null and its history shows actorType: serviceAccount.visibility defaults to shared (the whole team sees it). Send private to limit it to the assignee.assigneeUserId must be an active member of the workspace (userId from Get Workspace Users), otherwise 403 with "Assignee must be an active member of this workspace.".conversationId (optionally with conversationEventId) or contactId. When a conversation is linked, the contact is taken from it and contactId is ignored. Every linked record must belong to the same workspace.projectId / sectionId / parentTaskId place the task; use List Task Projects and List Task Sections to find IDs.properties; get definitions from List Task Properties.reminderOffsetMinutes – sending one fails; set it afterwards with Set Task Reminder.callContactSuggestionId – rejected with a validation error.403.curl --location 'https://api.voxa.sa/v1/tasks/service-account' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"title": "Call back about the renewal quote",
"description": "Customer asked for the 12-month price.",
"assigneeUserId": "3a1d0c11-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"visibility": "shared",
"priority": "p2",
"dueAtUtc": "2026-10-22T09:00:00Z",
"contactId": "3a1c9f20-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}'{
"id": "3a1ebef0-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"title": "Call back about the renewal quote",
"description": "Customer asked for the 12-month price.",
"status": "open",
"priority": "p2",
"visibility": "shared",
"assigneeUserId": "3a1d0c11-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"assigneeName": "Sara",
"dueAtUtc": "2026-10-22T09:00:00Z",
"isOverdue": false,
"scheduledAtUtc": null,
"durationMinutes": null,
"reminderOffsetMinutes": null,
"reminderAtUtc": null,
"reminderNotifiedAtUtc": null,
"projectId": null,
"sectionId": null,
"parentTaskId": null,
"position": 1024,
"childCount": 0,
"conversationId": null,
"conversationEventId": null,
"contactId": "3a1c9f20-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"contactName": "Ahmed Ali",
"attachments": [],
"properties": [],
"creatorId": null,
"creatorName": null,
"agentId": null,
"creationTime": "2026-10-20T10:00:00Z",
"completedAtUtc": null,
"subtasks": {
"totalCount": 0,
"items": []
},
"activities": null
}