Podio API Documentation

Tasks: Create task

POST /task/

Creates a new task.

PHP Client
PodioTask::create( $attributes = array(), $options = array() );
Ruby Gem
Podio::Task.create( attributes, options = {} )

True if hooks should be executed for the change, false otherwise.

Default value: true

If set to true, the object will not be bumped up in the stream and notifications will not be generated.

Default value: false
Request { "text": The text of the task, "description": The description of the task (optional),
"private": True if the task should be private, false otherwise, "due_date": The due date of the task, if any (in local time), "due_time": The due time of the task, if any (in local time), "due_on": The due date and time of the task, if any (in UTC),
"ref_type": Optional ref type to which the task is attached to
"ref_id": Optional ref id to which the task is attached to, "responsible": The contact(s) responsible for the task, identified by either:
An integer (user_id)
A {"type": contact identifier type, "id": contact identifier value} object
A list of integers and/or contact identifier objects (with 5 supported contact identifier types: "user", "profile", "mail", "space", "external"), "file_ids": The list of files to attach to this task, [ "{file_id}", ... (more files) ], "labels": The list of labels in text form [ "{label}", ... (more labels) ], "label_ids": The list labels in id form [ "{label_id}", ... (more labels) ], "reminder": Optional reminder on this task { "remind_delta": Minutes (integer) to remind before the due date }, "recurrence": The recurrence for the task, if any, { "name": The name of the recurrence, "weekly", "monthly" or "yearly", "config": The configuration for the recurrence, depends on the type { "days": List of weekdays ("monday", "tuesday", etc) (for "weekly"), "repeat_on": When to repeat, "day_of_week" or "day_of_month" (for "monthly") }, "step": The step size, 1 or more, "until": The latest date the recurrence should take place }, "external_id": Any external id for the task, if from another system }
Response { "task_id": The id of the newly created task, ... (more properties, see the get task operation) }


The sandbox only handles GET operations for now.