curl --request POST \
--url https://api.statisfy.com/v1/objects/task/records \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"account": null,
"assignee": null,
"description": null,
"due_date": null,
"fields": {},
"parent": null,
"priority": null,
"project": null,
"start_date": null,
"status": null,
"title": null,
"type": null
}
'import requests
url = "https://api.statisfy.com/v1/objects/task/records"
payload = {
"account": None,
"assignee": None,
"description": None,
"due_date": None,
"fields": {},
"parent": None,
"priority": None,
"project": None,
"start_date": None,
"status": None,
"title": None,
"type": None
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account: null,
assignee: null,
description: null,
due_date: null,
fields: {},
parent: null,
priority: null,
project: null,
start_date: null,
status: null,
title: null,
type: null
})
};
fetch('https://api.statisfy.com/v1/objects/task/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.statisfy.com/v1/objects/task/records",
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([
'account' => null,
'assignee' => null,
'description' => null,
'due_date' => null,
'fields' => [
],
'parent' => null,
'priority' => null,
'project' => null,
'start_date' => null,
'status' => null,
'title' => null,
'type' => null
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.statisfy.com/v1/objects/task/records"
payload := strings.NewReader("{\n \"account\": null,\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"parent\": null,\n \"priority\": null,\n \"project\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null,\n \"type\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.statisfy.com/v1/objects/task/records")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"account\": null,\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"parent\": null,\n \"priority\": null,\n \"project\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null,\n \"type\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/objects/task/records")
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 \"account\": null,\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"parent\": null,\n \"priority\": null,\n \"project\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null,\n \"type\": null\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"account": "<string>",
"account_name": "<string>",
"activity": "<string>",
"assignee": "<string>",
"assignee_name": "<string>",
"assignee_type": "user",
"created_at": "<string>",
"creator": "<string>",
"description": "<string>",
"due_date": "<string>",
"fields": {},
"parent": "<string>",
"priority": "low",
"project": "<string>",
"project_name": "<string>",
"start_date": "<string>",
"status": "<string>",
"status_group": "not_started",
"title": "<string>",
"type": "activity_task",
"updated_at": "<string>"
}Create a task
Creates a task and returns it with 201: the app’s own create. title is required, and the task is on an account (a live account’s id) or in a project (a project’s id; the task is then on the project’s account, and account may be left out). type defaults to activity_task; a task in a project may also be a project or milestone, and its parent may name a task in the same project (a milestone takes none), while a task on an account takes any type but those two. status is a status name, matched exactly, from the task’s status template, the one the app’s status picker offers for it: a project’s tasks use the project’s template, else its project template’s, else the global one; other tasks use their type’s, else the global one. When not sent, the API picks that template’s TODO status, else its first not-started one. assignee is a user’s id or a contact of the task’s account; with none, the task is unassigned. A person’s own key (the MCP server’s connection) makes that person the task’s creator; an org key makes no one. priority (low, medium or high), start_date and due_date (YYYY-MM-DD, start not after due), description and custom fields under fields are optional; the custom fields are those of the task’s type and of its project. Every key is checked before anything is written, and any problem refuses the whole request with a 422 listing each one in details. A project synced from another tool (Jira, Wrike, Linear, Rocketlane) manages its tasks: creating one in it is a 409, ahead of any other problem. As in the app, an assigned user is then emailed (a contact is not). A 500 that says the task was created, or may have been, names it in details (task_ids): do not create it again. Send an Idempotency-Key header to make a retry safe: the same key replays the first answer, including such a 500.
curl --request POST \
--url https://api.statisfy.com/v1/objects/task/records \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"account": null,
"assignee": null,
"description": null,
"due_date": null,
"fields": {},
"parent": null,
"priority": null,
"project": null,
"start_date": null,
"status": null,
"title": null,
"type": null
}
'import requests
url = "https://api.statisfy.com/v1/objects/task/records"
payload = {
"account": None,
"assignee": None,
"description": None,
"due_date": None,
"fields": {},
"parent": None,
"priority": None,
"project": None,
"start_date": None,
"status": None,
"title": None,
"type": None
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account: null,
assignee: null,
description: null,
due_date: null,
fields: {},
parent: null,
priority: null,
project: null,
start_date: null,
status: null,
title: null,
type: null
})
};
fetch('https://api.statisfy.com/v1/objects/task/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.statisfy.com/v1/objects/task/records",
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([
'account' => null,
'assignee' => null,
'description' => null,
'due_date' => null,
'fields' => [
],
'parent' => null,
'priority' => null,
'project' => null,
'start_date' => null,
'status' => null,
'title' => null,
'type' => null
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.statisfy.com/v1/objects/task/records"
payload := strings.NewReader("{\n \"account\": null,\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"parent\": null,\n \"priority\": null,\n \"project\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null,\n \"type\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.statisfy.com/v1/objects/task/records")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"account\": null,\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"parent\": null,\n \"priority\": null,\n \"project\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null,\n \"type\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/objects/task/records")
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 \"account\": null,\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"parent\": null,\n \"priority\": null,\n \"project\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null,\n \"type\": null\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"account": "<string>",
"account_name": "<string>",
"activity": "<string>",
"assignee": "<string>",
"assignee_name": "<string>",
"assignee_type": "user",
"created_at": "<string>",
"creator": "<string>",
"description": "<string>",
"due_date": "<string>",
"fields": {},
"parent": "<string>",
"priority": "low",
"project": "<string>",
"project_name": "<string>",
"start_date": "<string>",
"status": "<string>",
"status_group": "not_started",
"title": "<string>",
"type": "activity_task",
"updated_at": "<string>"
}Authorizations
An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.
Body
A create body in the task's own shape: standard keys at the top level, custom
keys under fields. title and one of account / project are required.
Response
Successful Response
Was this page helpful?