---
title: "Assign a Task"
method: POST
path: "/task/assign"
tags: ["tasks"]
---

# Assign a Task

`POST /task/assign`

This will assign a task to one or more contacts.

## Request body

- TaskAssignParams
  - `objectID` integer, required
  - `ids` integer[], required — List of Contact IDs
  - `group_id` integer — Group ID as an integer
  - `message` TaskMessage
    - `id` integer — Task Message ID to assign
    - `due_date` integer — Number of days until this task is due
    - `task_owner` integer

## Response `200`

Successfully assigned tasks

- Response
  - `code` integer, required
  - `data` object, required
  - `account_id` integer, required

## Other responses

- `400` — Error assigning tasks
- `403` — No permissions

---

[API](https://skmtc.net/ontraport/apis/ontraport-api.md) · [All operations](https://skmtc.net/ontraport/apis/ontraport-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontraport/ontraport-api/revisions/edcd035d71f5/schema)
