Create Task

Create a new task. Optionally link it to an opportunity, property, or person as a reference.

body titlestringrequired

Task title (1-500 characters).

body descriptionstring

Task description (max 5,000 characters).

body opportunity_idstring

Link to a CRM opportunity (numeric or UUID).

body property_idstring

Link to a property (e.g., prop_12345).

body person_idstring

Link to a person (e.g., per_67890).

body assigned_to_user_idinteger

User ID to assign the task to.

body due_datestring

Due date in ISO 8601 format.

Request example

12345678910curl -X POST "https://api.v2.dealmachine.com/v1/tasks" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Schedule property walkthrough",
    "description": "Contact seller to arrange a visit",
    "property_id": "prop_12345",
    "assigned_to_user_id": 12,
    "due_date": "2026-03-10T00:00:00Z"
  }'

Response example

123456789101112131415161718192021{
  "data": {
    "id": "task_003",
    "organization_id": 1,
    "opportunity_id": null,
    "property_id": "prop_12345",
    "person_id": null,
    "created_by_user_id": 5,
    "assigned_to_user_id": 12,
    "assigned_to_agent_id": null,
    "title": "Schedule property walkthrough",
    "description": null,
    "is_completed": false,
    "completed_at": null,
    "completed_by_user_id": null,
    "due_date": "2026-03-10T00:00:00Z",
    "sort_order": 0,
    "created_at": "2026-03-05T09:00:00Z",
    "updated_at": "2026-03-05T09:00:00Z"
  }
}