missive_create_task
Create tasks in Missive as standalone items, as tasked conversations, or as subtasks inside conversations. Requires a title; supports assignment, due dates, and organization settings.
Instructions
Creates a task in Missive (standalone task, tasked conversation, or a subtask inside a conversation). Tasks created via the API appear in the Tasks view, not the Inbox. title is required; organization is required when using team, assignees, or add_users (defaults to MISSIVE_DEFAULT_ORGANIZATION); a subtask requires conversation or references.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | Team ID to assign the task to. For a standalone task, either `team` or `assignees` is required. | |
| state | No | Initial task state: 'todo', 'in_progress', or 'closed'. Defaults to 'todo'. | |
| title | Yes | Task title (required, max 1000 characters). | |
| due_at | No | Unix timestamp for when the task is due. | |
| subtask | No | Set true to create this task as a subtask inside a conversation. Requires `conversation` or `references`. | |
| add_users | No | User IDs to add to the parent conversation (subtasks only). Requires `organization`. | |
| assignees | No | Array of user IDs to assign the task to. For a standalone task, either `team` or `assignees` is required. | |
| references | No | Message references (e.g. email Message-IDs) used to find or create the parent conversation for a subtask, as an alternative to `conversation`. | |
| description | No | Task description, plain text (max 10000 characters). | |
| add_to_inbox | No | Set true to move the parent conversation to the Inbox for everyone with access (subtasks only). | |
| conversation | No | Parent conversation ID for a subtask (required when `subtask` is true). | |
| organization | No | Organization ID. Required when using `team`, `assignees`, or `add_users`. Defaults to MISSIVE_DEFAULT_ORGANIZATION if set. | |
| conversation_subject | No | Subject for the parent conversation when creating it via `references` (only used when a new conversation is created). |