Create Task Item
create_task_itemCreate a task item on a Procore project by providing project_id and optional fields such as title, status, due date, and assignees. Returns the new task item with its ID.
Instructions
Creates a task item on a given project. Pass the record's fields as top-level arguments — they are nested under "task_item" in the request payload for you. Creates the task item and returns it with its new id (HTTP 201); calling it again creates another record. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: project_id. Procore API: Core > Tasks. Endpoint: POST /rest/v1.0/task_items
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Query string parameter — serialization view for the created task item in the response. Defaults to **`extended`** when omitted. | |
| title | No | JSON request body field — the title for this Tasks operation | |
| number | No | JSON request body field — the number for this Tasks operation | |
| status | No | JSON request body field — the status for this Tasks operation | |
| private | No | JSON request body field — privacy flag | |
| due_date | No | JSON request body field — due date in YYYY-MM-DD format | |
| form_ids | No | JSON request body field — forms to attach to the response | |
| image_ids | No | JSON request body field — images to attach to the response | |
| project_id | Yes | Query string parameter — unique identifier for the project. | |
| upload_ids | No | JSON request body field — uploads to attach to the response | |
| assigned_id | No | JSON request body field — unique identifier of the assigned | |
| attachments | No | JSON request body field — task Item attachments. To upload attachments you must upload the entire payload as `multipart/form-data` content-type and specify each parameter as form-data together with `attachments[]` as files. | |
| description | No | JSON request body field — the description for this Tasks operation | |
| assignee_ids | No | JSON request body field — array of assignee identifiers | |
| file_version_ids | No | JSON request body field — file Versions to attach to the response | |
| prostore_file_ids | No | JSON request body field — array of prostore file identifiers | |
| drawing_revision_ids | No | JSON request body field — drawing Revisions to attach to the response | |
| task_item_category_id | No | JSON request body field — the task item category to associate with the task item. | |
| distribution_member_ids | No | JSON request body field — distribution Member IDs | |
| document_management_document_revision_ids | No | JSON request body field — pDM document to attach to the response |