Connectors Reference

Toodledo

Toodledo is a powerful online productivity tool. Manage your to-do list by creating and updating tasks.

 

Status: Preview

Tier: Standard

Version: 1.0.0

 

Actions:

Name

Summary

ListTasks ([Optional]integer comp)

Get a list of tasks

CreateTask (NewTask task)

Create a task

GetTaskById (integer id)

Get task

UpdateTask (Task task)

Update task

GetFolders ()

Get folders

 

Triggers:

Name

Summary

TrigOnNewTask ()

When a new task is created or updated

 

Objects:

Name

Summary

Folder

 

NewTask

 

Task

 

 

Actions:

ListTasks

Summary: Get a list of tasks

Description: Returns a list of tasks (up to 1000 results).

 

Syntax:

Toodledo.ListTasks ([Optional]integer comp)

 

Parameters:

Name

Type

Summary

Required

Related Action

comp

integer(int32)

(Completed)

Set to 0 to find only uncompleted tasks or 1 to find only completed tasks. Default includes both.

False

 

Returns:

          Type:array of (Task)

 

CreateTask

Summary: Create a task

Description: Create a new task with the specified fields.

 

Syntax:

Toodledo.CreateTask (NewTask task)

 

Parameters:

Name

Type

Summary

Required

Related Action

task

NewTask

 

 

True

 

Returns:

          Type:Task

 

GetTaskById

Summary: Get task

Description: Get a task by id.

 

Syntax:

Toodledo.GetTaskById (integer id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int32)

(Task Id)

The server id number for this task.

True

 

Returns:

          Type:Task

 

UpdateTask

Summary: Update task

Description: Update the fields for an existing task.

 

Syntax:

Toodledo.UpdateTask (Task task)

 

Parameters:

Name

Type

Summary

Required

Related Action

task

Task

 

 

True

 

Returns:

          Type:Task

 

GetFolders

Summary: Get folders

Description: Get a list of folders.

 

Syntax:

Toodledo.GetFolders ()

 

Returns:

          Type:array of (Folder)

 

Triggers:

Trigger TrigOnNewTask

Summary: When a new task is created or updated

Description: Triggers a new workflow when a task is created or updated.

 

Syntax:

Toodledo.TrigOnNewTask ()

 

Returns:

          Type:array of (Task)

 


 

Folder

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Id

The id number of the folder.

name

string

Name

A text string up to 32 characters.

archived

integer(int32)

Archived

A boolean value indicating whether the folder has been archived.

private

integer(int32)

Private

A boolean value indicating whether the folder has been shared with other people.

order

integer(int32)

Order

An integer representing the preferred order for listing folders with 1 being the top.


 

NewTask

Summary:

Description:

 

          Properties:

Name

Type

Summary

title

string

Title

A string for the name of the task. Up to 255 characters.

folder

integer(int32)

Folder Id

The id number of the folder. Omit this field or set it to 0 to leave the task unassigned to a folder.

priority

integer(int32)

Priority

An integer that represents the priority of the task.

note

string

Note

A text string up to 32,000 bytes long. New lines should be sent as  .

duedate

string(date-time)

Due Date

A timestamp for when the task is due. The time component of this timestamp doesn't matter.

duetime

string(date-time)

Due Time

A timestamp for when the task is due. If the task does not have a time set, then this will be empty.


 

Task

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Id

The server id number for this task.

title

string

Title

A string for the name of the task.

completed

string(date-time)

Completed

A timestamp for when the task was completed. If the task is not completed, the value will be 0.

duedate

string(date-time)

Due Date

A timestamp for when the task is due.

duetime

string(date-time)

Due Time

A timestamp for when the task is due. If the task does not have a time set, then this will be empty.

note

string

Note

A text string up to 32,000 bytes long.

priority

integer(int32)

Priority

An integer that represents the priority.

folder

integer(int32)

Folder

The id number of the folder. If unassigned to a folder, the value will be 0.

modified

string(date-time)

Modified

A timestamp for when the task was last modified.