Create a Task
curl --request POST \
--url https://api.virtuoussoftware.com/api/Task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship.",
"dueDateTime": "2026-10-20T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship.',
dueDateTime: '2026-10-20T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
fetch('https://api.virtuoussoftware.com/api/Task', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.virtuoussoftware.com/api/Task"
payload = {
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship.",
"dueDateTime": "2026-10-20T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.virtuoussoftware.com/api/Task");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship.\",\n \"dueDateTime\": \"2026-10-20T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.virtuoussoftware.com/api/Task",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'taskType' => 'General',
'task' => 'Call Jane about the spring gala',
'description' => 'Confirm her table sponsorship.',
'dueDateTime' => '2026-10-20T15:00:00',
'contactId' => 10,
'contactIndividualId' => 22
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://api.virtuoussoftware.com/api/Task")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship.\",\n \"dueDateTime\": \"2026-10-20T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.virtuoussoftware.com/api/Task")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship.\",\n \"dueDateTime\": \"2026-10-20T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}"
response = http.request(request)
puts response.read_bodyconst url = 'https://api.virtuoussoftware.com/api/Task';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship.',
dueDateTime: '2026-10-20T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"message": "Authorization has been denied for this request."
}{
"message": "You do not have permission to perform this action."
}{
"message": "Rate limit exceeded. Try again later."
}{
"id": 5,
"taskType": "General",
"task": "Remind me to call mom",
"description": "Tell her the caserole was great!",
"dueDateTime": "2022-02-10T15:00:00",
"dueDateTimeUtc": "2022-02-10T22:00:00Z",
"taskStatus": "NotStarted",
"taskStatusDisplayName": "Not Started",
"resolutionDateTimeUtc": null,
"isResolved": false,
"isPastDue": false,
"taskKind": "Reminder",
"taskKindDisplayName": "Task",
"contactId": 10,
"contactIndividualId": null,
"contact": "Mom",
"contactUrl": "https://api.virtuoussoftware.com/api/Contact/10"
}Tasks
Create a Task
POST
/
api
/
Task
Create a Task
curl --request POST \
--url https://api.virtuoussoftware.com/api/Task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship.",
"dueDateTime": "2026-10-20T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship.',
dueDateTime: '2026-10-20T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
fetch('https://api.virtuoussoftware.com/api/Task', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.virtuoussoftware.com/api/Task"
payload = {
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship.",
"dueDateTime": "2026-10-20T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.virtuoussoftware.com/api/Task");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship.\",\n \"dueDateTime\": \"2026-10-20T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.virtuoussoftware.com/api/Task",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'taskType' => 'General',
'task' => 'Call Jane about the spring gala',
'description' => 'Confirm her table sponsorship.',
'dueDateTime' => '2026-10-20T15:00:00',
'contactId' => 10,
'contactIndividualId' => 22
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.post("https://api.virtuoussoftware.com/api/Task")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship.\",\n \"dueDateTime\": \"2026-10-20T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.virtuoussoftware.com/api/Task")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship.\",\n \"dueDateTime\": \"2026-10-20T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}"
response = http.request(request)
puts response.read_bodyconst url = 'https://api.virtuoussoftware.com/api/Task';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship.',
dueDateTime: '2026-10-20T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"message": "Authorization has been denied for this request."
}{
"message": "You do not have permission to perform this action."
}{
"message": "Rate limit exceeded. Try again later."
}{
"id": 5,
"taskType": "General",
"task": "Remind me to call mom",
"description": "Tell her the caserole was great!",
"dueDateTime": "2022-02-10T15:00:00",
"dueDateTimeUtc": "2022-02-10T22:00:00Z",
"taskStatus": "NotStarted",
"taskStatusDisplayName": "Not Started",
"resolutionDateTimeUtc": null,
"isResolved": false,
"isPastDue": false,
"taskKind": "Reminder",
"taskKindDisplayName": "Task",
"contactId": 10,
"contactIndividualId": null,
"contact": "Mom",
"contactUrl": "https://api.virtuoussoftware.com/api/Contact/10"
}Authorizations
Body
application/json
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.
Last modified on April 23, 2026
Was this page helpful?