Connectors Reference

Wunderlist

Wunderlist provide a to-do list and task manager to help people get their stuff done.  Whether you are sharing a grocery list with a loved one, working on a project, or planning a vacation, Wunderlist makes it easy to capture, share, and complete your to-dos. Wunderlist instantly syncs between your phone, tablet and computer, so you can access all your tasks from anywhere.

 

Status: Production

Tier: Standard

Version: 1.0

 

Actions:

Name

Summary

RetrieveLists ()

Get lists

CreateList (NewList post)

Create a list

ListTasks (integer list_id, [Optional]boolean completed)

Get tasks for a list

CreateTask (NewTask post)

Create a task

ListSubTasks (integer list_id, [Optional]integer task_id, [Optional]boolean completed)

Get subtasks

CreateSubTask (NewSubtask post)

Create a subtask

ListNotes (integer list_id, [Optional]integer task_id)

Get notes

CreateNote (NewNote post)

Create a note

ListComments (integer list_id, [Optional]integer task_id)

Get task comments

CreateComment (NewComment post)

Add a comment to a task

RetrieveReminders (integer list_id, [Optional]integer task_id)

Get reminders

CreateReminder (NewReminder post)

Set a reminder

RetrieveFiles (integer list_id, [Optional]integer task_id)

Get files

GetList (integer id)

Get list

DeleteList (integer id, integer revision)

Delete list

UpdateList (integer id, UpdateList post)

Update a list

GetTask (integer list_id, integer id)

Get task

DeleteTask (integer list_id, integer id, integer revision)

Delete task

UpdateTask (integer list_id, integer id, UpdateTask post)

Update a task

GetSubTask (string id)

Get subtask

DeleteSubTask (integer id, integer revision)

Delete a subtask

UpdateSubTask (integer id, UpdateSubtask post)

Update a subtask

GetNote (string id)

Get a note

DeleteNote (integer id, integer revision)

Delete a note

UpdateNote (integer id, UpdateNote post)

Update a note

GetComment (string id)

Get a task comment

DeleteReminder (integer id, integer revision)

Delete a reminder

UpdateReminder (integer id, UpdateReminder post)

Update a reminder

 

Triggers:

Name

Summary

TriggerTaskDue (integer list_id)

When a task is due

TriggerTaskNew (integer list_id)

When a new task is created

TriggerReminder (integer list_id, [Optional]integer task_id)

When a reminder occurs

 

Objects:

Name

Summary

Comment

 

CreatedList

 

File

 

List

 

NewComment

 

NewList

 

NewNote

 

NewReminder

 

NewSubtask

 

NewTask

 

Note

 

Reminder

 

Subtask

 

Task

 

UpdateList

 

UpdateNote

 

UpdateReminder

 

UpdateSubtask

 

UpdateTask

 

 

Actions:

RetrieveLists

Summary: Get lists

Description: This operation retrieves the task lists associated with your account.

 

Syntax:

Wunderlist.RetrieveLists ()

 

Returns:

          Type:array of (List)

          Summary: Task List Array

 

CreateList

Summary: Create a list

Description: This operation is used to create a new task list.

 

Syntax:

Wunderlist.CreateList (NewList post)

 

Parameters:

Name

Type

Summary

Required

Related Action

post

NewList

 

Properties of a new task list.

True

 

Returns:

          Type:CreatedList

          Description: Properties of the newly created task list.

 

ListTasks

Summary: Get tasks for a list

Description: This operation is used to retrieve all tasks from a specific list.

 

Syntax:

Wunderlist.ListTasks (integer list_id, [Optional]boolean completed)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique identifier of the list.

True

RetrieveLists

completed

boolean

(Show Completed)

True to show completed tasks.

False

 

Returns:

          Type:array of (Task)

 

CreateTask

Summary: Create a task

Description: This operation is used to create a new task.

 

Syntax:

Wunderlist.CreateTask (NewTask post)

 

Parameters:

Name

Type

Summary

Required

Related Action

post

NewTask

 

Properties of a new task.

True

 

Returns:

          Type:Task

          Description: Properties associated with a single task.

 

ListSubTasks

Summary: Get subtasks

Description: This operation is used to retrieve subtasks from a specific list or from a specific task.

 

Syntax:

Wunderlist.ListSubTasks (integer list_id, [Optional]integer task_id, [Optional]boolean completed)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

task_id

integer(int64)

(Task Id)

Unique id of the task.

False

ListTasks

completed

boolean

(Show Completed)

True to show completed tasks.

False

 

Returns:

          Type:array of (Subtask)

 

CreateSubTask

Summary: Create a subtask

Description: This operation is used to create a subtask within a specific task.

 

Syntax:

Wunderlist.CreateSubTask (NewSubtask post)

 

Parameters:

Name

Type

Summary

Required

Related Action

post

NewSubtask

 

Properties of a new subtask.

True

 

Returns:

          Type:Subtask

          Description: Properties of a single subtask.

 

ListNotes

Summary: Get notes

Description: This operation is used to retrieve notes for a specific list or a task.

 

Syntax:

Wunderlist.ListNotes (integer list_id, [Optional]integer task_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

task_id

integer(int64)

(Task Id)

Unique id of the task.

False

ListTasks

 

Returns:

          Type:array of (Note)

 

CreateNote

Summary: Create a note

Description: This operation is used to add a note to a specific task.

 

Syntax:

Wunderlist.CreateNote (NewNote post)

 

Parameters:

Name

Type

Summary

Required

Related Action

post

NewNote

 

Properties of a new note.

True

 

Returns:

          Type:Note

          Description: Properties of a single note.

 

ListComments

Summary: Get task comments

Description: This operation retrieves task comments for a specific list or a task.

 

Syntax:

Wunderlist.ListComments (integer list_id, [Optional]integer task_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

task_id

integer(int64)

(Task Id)

Unique id of the task.

False

ListTasks

 

Returns:

          Type:array of (Comment)

 

CreateComment

Summary: Add a comment to a task

Description: This operation is used to add a comment to a specific task.

 

Syntax:

Wunderlist.CreateComment (NewComment post)

 

Parameters:

Name

Type

Summary

Required

Related Action

post

NewComment

 

Properties of a new note.

True

 

Returns:

          Type:Comment

          Description: Properties of a task comment.

 

RetrieveReminders

Summary: Get reminders

Description: This operation is used to retrieve reminders for a specific list or a specific task.

 

Syntax:

Wunderlist.RetrieveReminders (integer list_id, [Optional]integer task_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

task_id

integer(int64)

(Task Id)

Unique id of the task.

False

ListTasks

 

Returns:

          Type:array of (Reminder)

 

CreateReminder

Summary: Set a reminder

Description: This operation is used to set a reminder.

 

Syntax:

Wunderlist.CreateReminder (NewReminder post)

 

Parameters:

Name

Type

Summary

Required

Related Action

post

NewReminder

 

Properties of a new subtask.

True

 

Returns:

          Type:Reminder

          Description: Properties associated with a task reminder.

 

RetrieveFiles

Summary: Get files

Description: This operation is used to retrieve files for a specific list or a specific task.

 

Syntax:

Wunderlist.RetrieveFiles (integer list_id, [Optional]integer task_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

task_id

integer(int64)

(Task Id)

Unique id of the task.

False

ListTasks

 

Returns:

          Type:array of (File)

 

GetList

Summary: Get list

Description: This operation retrieves the details of a specific list.

 

Syntax:

Wunderlist.GetList (integer id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

 

Returns:

          Type:List

          Description: Properties of a task list.

 

DeleteList

Summary: Delete list

Description: This operation is used to delete a list.

 

Syntax:

Wunderlist.DeleteList (integer id, integer revision)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

revision

integer(int64)

(Revision)

Version count of the list.

True

 

Returns:

 

UpdateList

Summary: Update a list

Description: This operation is used to update a specific list.

 

Syntax:

Wunderlist.UpdateList (integer id, UpdateList post)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

post

UpdateList

 

Properties associated with a list.

True

 

Returns:

          Type:List

          Description: Properties of a task list.

 

GetTask

Summary: Get task

Description: This operation retrieves the details of a specific task.

 

Syntax:

Wunderlist.GetTask (integer list_id, integer id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

id

integer(int64)

(Task Id)

Unique id of the task.

True

ListTasks

 

Returns:

          Type:Task

          Description: Properties associated with a single task.

 

DeleteTask

Summary: Delete task

Description: This operation is used to delete a specific task.

 

Syntax:

Wunderlist.DeleteTask (integer list_id, integer id, integer revision)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

id

integer(int64)

(Task Id)

Unique id of the task.

True

ListTasks

revision

integer(int64)

(Revision)

Version count of the task.

True

 

Returns:

 

UpdateTask

Summary: Update a task

Description: This operation is used to update a specific task.

 

Syntax:

Wunderlist.UpdateTask (integer list_id, integer id, UpdateTask post)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique id of the list.

True

RetrieveLists

id

integer(int64)

(Task Id)

Unique id of the task.

True

ListTasks

post

UpdateTask

 

Properties associated with a single task.

True

 

Returns:

          Type:Task

          Description: Properties associated with a single task.

 

GetSubTask

Summary: Get subtask

Description: This operation is used to retrieve the details of a specific subtask.

 

Syntax:

Wunderlist.GetSubTask (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Subtask Id)

Unique id of the subtask.

True

 

Returns:

          Type:Subtask

          Description: Properties of a single subtask.

 

DeleteSubTask

Summary: Delete a subtask

Description: This operation is used to delete a specific subtask.

 

Syntax:

Wunderlist.DeleteSubTask (integer id, integer revision)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Subtask Id)

Unique id of the subtask.

True

revision

integer(int64)

(Revision)

Version count of the subtask.

True

 

Returns:

 

UpdateSubTask

Summary: Update a subtask

Description: This operation is used to update a specific subtask.

 

Syntax:

Wunderlist.UpdateSubTask (integer id, UpdateSubtask post)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Subtask Id)

Unique id of the subtask.

True

post

UpdateSubtask

 

Properties associated with a single subtask.

True

 

Returns:

          Type:Subtask

          Description: Properties of a single subtask.

 

GetNote

Summary: Get a note

Description: This operation is used to retrieve details of a specific note.

 

Syntax:

Wunderlist.GetNote (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Note Id)

Unique id of the note.

True

 

Returns:

          Type:Note

          Description: Properties of a single note.

 

DeleteNote

Summary: Delete a note

Description: This operation is used to delete a specific note.

 

Syntax:

Wunderlist.DeleteNote (integer id, integer revision)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Note Id)

Unique id of the note.

True

revision

integer(int64)

(Revision)

Version count of the note.

True

 

Returns:

 

UpdateNote

Summary: Update a note

Description: This operation is used to update a specific note.

 

Syntax:

Wunderlist.UpdateNote (integer id, UpdateNote post)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Note Id)

Unique id of the note.

True

post

UpdateNote

 

Properties of a single note.

True

 

Returns:

          Type:Note

          Description: Properties of a single note.

 

GetComment

Summary: Get a task comment

Description: This operation is used to retrieve details of a specific task comment.

 

Syntax:

Wunderlist.GetComment (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Comment Id)

Unique id of the comment.

True

 

Returns:

          Type:Comment

          Description: Properties of a task comment.

 

DeleteReminder

Summary: Delete a reminder

Description: This operation is used to delete a specific reminder.

 

Syntax:

Wunderlist.DeleteReminder (integer id, integer revision)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Reminder Id)

Unique id of the reminder.

True

revision

integer(int64)

(Revision)

Version count of the reminder.

True

 

Returns:

 

UpdateReminder

Summary: Update a reminder

Description: This operation is used to update a specific reminder.

 

Syntax:

Wunderlist.UpdateReminder (integer id, UpdateReminder post)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Reminder Id)

Unique id of the reminder.

True

post

UpdateReminder

 

Properties associated with a task reminder.

True

 

Returns:

          Type:Reminder

          Description: Properties associated with a task reminder.

 

Triggers:

Trigger TriggerTaskDue

Summary: When a task is due

Description: This operation triggers when a task in a specific list is due.

 

Syntax:

Wunderlist.TriggerTaskDue (integer list_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique identifier of the list.

True

RetrieveLists

 

Returns:

          Type:array of (Task)

 

Trigger TriggerTaskNew

Summary: When a new task is created

Description: Triggers when a new task is created in a specific list.

 

Syntax:

Wunderlist.TriggerTaskNew (integer list_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique identifier of the list.

True

RetrieveLists

 

Returns:

          Type:array of (Task)

 

Trigger TriggerReminder

Summary: When a reminder occurs

Description: Triggers when a task reminder occurs.

 

Syntax:

Wunderlist.TriggerReminder (integer list_id, [Optional]integer task_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

list_id

integer(int64)

(List Id)

Unique identifier of the list.

True

RetrieveLists

task_id

integer(int64)

(Task Id)

Unique identifier of the task.

False

ListTasks

 

Returns:

          Type:array of (Reminder)

 


 

Comment

Summary:

Description: Properties of a task comment.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique identifier of the comment.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

revision

integer(int64)

Revision

Version count of the comment.

text

string

Text

Body of the comment.

type

string

Type

Comment type.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)


 

CreatedList

Summary:

Description: Properties of the newly created task list.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique identifier of the task list.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

title

string

Title

Short summary of the task list.

type

string

Type

Task list type.

revision

integer(int64)

Revision

Version count of the list.


 

File

Summary:

Description: Properties associated with a single file.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique identifier of the file.

url

string

URL

URL

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

list_id

integer(int64)

List Id

Unique identifier of the parent list.

user_id

integer(int64)

UserId

Unique identifier of the person who created the file.

file_name

string

File Name

Filename

content_type

string

Content Type

Content Type

file_size

integer(int64)

File Size

File Size

local_created_at

string(date-time)

Local Created At

File creation time specified by the user

created_at

string(date-time)

Created Date-Time

Created At

updated_at

string(date-time)

Updated Date-Time

Updated At

type

string

Type

Type.

revision

integer(int64)

Revision

Version count of the file.


 

List

Summary:

Description: Properties of a task list.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique identifier of the task list.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

title

string

Title

Short summary of the task list.

list_type

string

List Type

Short summary of the list type.

type

string

Type

Type of tasks contained in the list.

revision

integer(int64)

Revision

Version count of the list.


 

NewComment

Summary:

Description: Properties of a new note.

 

          Properties:

Name

Type

Summary

list_id

integer(int64)

List Id

Unique identifier of the parent list.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

text

string

Text

Body of the comment.


 

NewList

Summary:

Description: Properties of a new task list.

 

          Properties:

Name

Type

Summary

title

string

Title

Short summary of the task list.


 

NewNote

Summary:

Description: Properties of a new note.

 

          Properties:

Name

Type

Summary

list_id

integer(int64)

List Id

Unique identifier of the parent list.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

content

string

Content

Body of the note.


 

NewReminder

Summary:

Description: Properties of a new subtask.

 

          Properties:

Name

Type

Summary

list_id

integer(int64)

List Id

Unique identifier of the parent list.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

date

string(date-time)

Date

Date when reminder should occur.


 

NewSubtask

Summary:

Description: Properties of a new subtask.

 

          Properties:

Name

Type

Summary

list_id

integer(int64)

List Id

Unique identifier of the parent list.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

title

string

Title

Short summary of the task.

completed

boolean

Completed

True if the task is complete.


 

NewTask

Summary:

Description: Properties of a new task.

 

          Properties:

Name

Type

Summary

list_id

integer(int64)

List Id

Unique id of the list.

title

string

Title

Short summary of the task list.

assignee_id

integer(int64)

Assignee Id

Unique id of the person assigned to the task.

completed

boolean

Completed

True if a task is complete.

recurrence_type

string

Recurrence Type

Day, week, month or year.  Values: [day, week, month, year]

recurrence_count

integer(int64)

Recurrence Count

Number of occurences.

due_date

string(date-time)

Due Date

Due Date yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

starred

boolean

Starred

True if the task is starred.


 

Note

Summary:

Description: Properties of a single note.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique identifier of the note.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

content

string

Content

Body of the note.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

updated_at

string(date-time)

Updated Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

revision

integer(int64)

Revision

Version count of the note.


 

Reminder

Summary:

Description: Properties associated with a task reminder.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique id of the reminder.

date

string(date-time)

Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

task_id

integer(int64)

TaskId

Unique id of the task.

revision

integer(int64)

Revision

Version count of the reminder.

type

string

Type

Summary of the reminder type.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

updated_at

string(date-time)

Updated At

Updated At


 

Subtask

Summary:

Description: Properties of a single subtask.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Id

Unique identifier of the subtask.

task_id

integer(int64)

Task Id

Unique identifier of the parent task.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

created_by_id

integer(int64)

Created By

Unique id of the person who created the subtask.

revision

integer(int64)

Revision

Version count of the subtask.

completed

boolean

Completed

True if the subtask is completed.

completed_at

string(date-time)

Completed Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

title

string

Title

Short summary of the subtask.

type

string

Type

Subtask type.


 

Task

Summary:

Description: Properties associated with a single task.

 

          Properties:

Name

Type

Summary

id

integer(int64)

Task Id

Unique identifier of the task.

assignee_id

integer(int64)

Assignee Id

Unique identifier of the person task is assigned to.

assigner_id

integer(int64)

Assigner Id

Unique identifier of the person who assigned the task.

created_at

string(date-time)

Created Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

created_by_id

integer(int64)

Created By

Unique identifier of the person who created the task.

due_date

string(date-time)

Due Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

list_id

integer(int64)

List Id

Unique identifier of the parent list.

revision

integer(int64)

Revision

Task version count.

starred

boolean

Starred

True if the task is starred.

title

string

Title

Short summary of the task.


 

UpdateList

Summary:

Description: Properties associated with a list.

 

          Properties:

Name

Type

Summary

revision

string

Revision

Version count of the list.

title

string

Title

Short summary of the list name.


 

UpdateNote

Summary:

Description: Properties of a single note.

 

          Properties:

Name

Type

Summary

revision

integer(int64)

Revision

Version count of the note.

content

string

Content

Body of the note.


 

UpdateReminder

Summary:

Description: Properties associated with a task reminder.

 

          Properties:

Name

Type

Summary

date

string(date-time)

Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

revision

integer(int64)

Revision

Version count of the reminder.


 

UpdateSubtask

Summary:

Description: Properties associated with a single subtask.

 

          Properties:

Name

Type

Summary

revision

integer(int64)

Revision

Revision

title

string

Title

Title

completed

boolean

Completed

Completed


 

UpdateTask

Summary:

Description: Properties associated with a single task.

 

          Properties:

Name

Type

Summary

revision

integer(int64)

Revision

Version count of the task.

title

string

Title

Short summary of the task.

assignee_id

string

Assignee Id

Unique identifier of the person task is assigned to.

completed

boolean

Completed

True if the task is complete.

recurrence_type

string

Recurrence Type

Day, week, month or year.  Values: [day, week, month, year]

recurrence_count

integer(int64)

Recurrence Count

Recurrence Count

due_date

string

Due Date-Time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

starred

boolean

Starred

True if the task is starred.