Create a task

Using TypeScript? Check out our GraphQL SDK for a fully typed client.

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

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

Update a task

⌘I

GraphQL API

Building Agents

Webhooks

Customer Cards

UI Components

Security