Create a task

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.

For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.

A task can be linked to either a company or a tenant, not both. This operation requires the following permissions:

task:create

Mutation

mutation createTask($input: CreateTaskInput!) {
  createTask(input: $input) {
    task {
      id
      ref
      title
      status
      priority
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "title": "Send onboarding follow-up",
    "description": "Reach out to confirm they got everything they need from the kickoff call.",
    "priority": 2,
    "companyId": "co_01HRRMRPERZCK42HTPD4JQ57NB",
    "assignedTo": {
      "userId": "u_01HXXXXXXXXXXXXXXXXXXXXXXX"
    }
  }
}

GraphQL API

Building Agents

Agent integrations

Webhooks

Channels

Customer Cards

UI Components

Security

Changelog