Skip to main content
POST
/
v1
/
tasks
curl -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"
  }'

{
  "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"
  }
}
Create a new task. Optionally link it to an opportunity, property, or person as a reference.
​
title
string
required
Task title (1-500 characters).
​
description
string
Task description (max 5,000 characters).
​
opportunity_id
string
Link to a CRM opportunity (numeric or UUID).
​
property_id
string
Link to a property (e.g., prop_12345).
​
person_id
string
Link to a person (e.g., per_67890).
​
assigned_to_user_id
integer
User ID to assign the task to.
​
due_date
string
Due date in ISO 8601 format.
curl -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"
  }'

{
  "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"
  }
}