Skip to main content
POST
Create Task
Create an organization task with a description, creator, status, and optional assignees.

Authentication

string
requerido
Organization API key. Keep it on your server or in a credential store.

Body

string
requerido
Detailed text, at least four characters.
string
requerido
Short description. Include it even though some generated API metadata labels it optional.
string
requerido
custom, AI, system, or automatization. Use custom for a user-created task.
string
requerido
Creator email. For custom tasks, the creator must be a member of the organization.
string[]
Member emails. They are resolved to user IDs.
string
backlog, todo, in_progress, done, blocked, or canceled. Default: todo.
string
low, medium, or high. Default: high.
object
Optional additional values.
Organization is derived from the key; do not send organization_id. Contact linkage is not supported by this creation flow: although a contact field appears in some schema metadata, it is not persisted by task creation.

Example

Replace the creator with an actual organization member before executing. This creates a real task.

Response

A successful creation returns HTTP 201 with statusCode and a data task object. See Get task for its fields. Creating a task records work to do; it does not itself execute a call or send a message. If a request times out, check existing tasks before repeating it.