Skip to main content
POST
Create a Task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
taskType
string
required

The type of task. Use List Task Types for valid values.

task
string
required

The task to be completed.

dueDateTime
string<date-time>
required

The due date and time of the task, local to the user.

description
string

Optional. A description of the task.

Maximum string length: 4000
contactId
integer

Optional. The contact this task is regarding.

contactIndividualId
integer

Optional. The contact individual (a person in the contact's household) this task is regarding. Requires contactId, and the individual must belong to that contact. Sending it without contactId returns 400 with the message under errors.ContactId.

Required range: x >= 1
ownerEmail
string

Optional. The email of the user who owns this task.

Response

The request was not authenticated. Either the Authorization header was missing, the API key or OAuth token was not sent as a bearer token, or the token has expired or been revoked. OAuth tokens last 15 days and must be refreshed; API keys do not expire but can be deleted in Virtuous.

The standard error envelope. message is always present and is the first thing to read when troubleshooting. modelState is present only for model validation failures (most 400 responses on endpoints that accept a body) and maps each rejected field to its validation messages.

message
string

A human readable explanation of why the request failed.

modelState
object

Field level validation messages, keyed by the field that was rejected. Keys are prefixed with the name of the model being bound (for example contact.firstName).

Last modified on April 23, 2026