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

# Create a task

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

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

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" />