> ## Documentation Index
> Fetch the complete documentation index at: https://guide.rolodexcrm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Task

## `POST` a task

`POST` `/user-api/v1/tasks`

### Headers

| **Header**          | **Value**           |
| ------------------- | ------------------- |
| `Content-Type`      | `application/json`  |
| `x-rolodex-api-key` | `f1e2d3c4b5a697...` |

### Required Fields

<ParamField path="body" type="string">
  Task description (minimum 1 character)
</ParamField>

<ParamField path="due_date" type="string">
  Due date in ISO datetime format
</ParamField>

### Optional Fields

<ParamField path="completed_at" type="string">
  Completion date in ISO datetime format
</ParamField>

### Request

```json theme={null}
{
  "body": "Prepare quarterly business review presentation",
  "due_date": "2025-01-25T16:00:00Z",
  "assignee": "user_456",
  "creator": "user_789",
  "contacts": [
    "contact_123",
    {
      "id": "contact_456"
    }
  ],
  "tags": [
    "tag_101",
    {
      "id": "tag_102"
    }
  ]
}
```

### Response

```json theme={null}
{
  "data": {
    "id": "task_99999",
    "body": "Prepare quarterly business review presentation",
    "due_date": "2025-01-25T16:00:00Z",
    "completed_at": null,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "contacts": [
      {
        "id": "contact_123",
        "full_name": "John Doe",
        "image_url": "https://example.com/avatar1.jpg"
      },
      {
        "id": "contact_456",
        "full_name": "Jane Smith",
        "image_url": "https://example.com/avatar2.jpg"
      }
    ],
    "assignee": {
      "id": "user_456",
      "full_name": "Alice Smith",
      "avatar_url": "https://example.com/user-avatar.jpg"
    },
    "creator": {
      "id": "user_789",
      "full_name": "Bob Johnson",
      "avatar_url": "https://example.com/creator-avatar.jpg"
    },
    "tags": [
      {
        "id": "tag_101",
        "name": "High Priority"
      },
      {
        "id": "tag_102",
        "name": "Sales"
      }
    ]
  }
}
```