> ## Documentation Index
> Fetch the complete documentation index at: https://plain-docs-orca-916-agent-docs-restructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a task

> Create a task with a title, and optionally a description, priority, assignee, and due date.

`title` is the only required input. You can optionally set a description, status, priority, assignee (a user or a machine user) and a parent company or tenant.

<Snippet file="graphql/sdk-note.mdx" />

A task can be linked to either a company or a tenant, not both.

This operation requires the following permissions:

* `task:create`

<Snippet file="graphql/create-task.mdx" />