Task lists

Endpointhttps://moneybird.com/api/v2

Task lists help you organize and track work within an administration. They contain groups of tasks that can be assigned to users and tracked for completion.

Returns information about a task list group

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_groups/{id}{format}

Returns information about a task list group, including its tasks.

Returns information about a task list group › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Returns information about a task list group › Responses

A task list group

id

string | integer · pattern: ^\d+$

A unique record identifier

name

string | null

row_order

integer

report_type

string | null

created_at

string · date-time

updated_at

string · date-time

object[]

GET/{administration_id}/task_list_groups/{id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/task_list_groups/:id:format

shell

Example Responses

{
  "id": "484282304043157087",
  "name": "Task list group #2",
  "row_order": 1,
  "report_type": null,
  "created_at": "2026-04-13T08:06:56.977Z",
  "updated_at": "2026-04-13T08:06:56.977Z",
  "tasks": [
    {
      "id": "484282304044205664",
      "administration_id": 123,
      "name": "Task #2",
      "description": "Description 2",
      "row_order": 0,
      "completed_at": null,
      "report_type": null,
      "task_lists_group_id": "484282304043157087",
      "parent_task_id": null,
      "created_at": "2026-04-13T08:06:56.978Z",
      "updated_at": "2026-04-13T08:06:56.978Z",
      "assignee_id": null,
      "subtasks": [],
      "notes": [],
      "events": [
        {
          "administration_id": 123,
          "user_id": "484282135833740389",
          "action": "task_lists_task_created",
          "link_entity_id": null,
          "link_entity_type": null,
          "data": {},
          "created_at": "2026-04-13T08:06:56.979Z",
          "updated_at": "2026-04-13T08:06:56.979Z"
        }
      ]
    }
  ]
}

json

application/json

Deletes a task list group

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_groups/{id}{format}

Permanently deletes a task list group and all its tasks.

Deletes a task list group › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Deletes a task list group › Responses

Group deleted

No data returned

Updates a task list group

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_list_groups/{id}{format}

Updates a task list group's name or report type. Updating the report type will destroy all tasks and generate new tasks based on the new report.

Updates a task list group › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Updates a task list group › Request Body

object

Updates a task list group › Responses

Group updated

id

string | integer · pattern: ^\d+$

A unique record identifier

name

string | null

row_order

integer

report_type

string | null

created_at

string · date-time

updated_at

string · date-time

object[]

PATCH/{administration_id}/task_list_groups/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/task_list_groups/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "group": {
    "name": "Updated Group"
  }
}
'

shell

Example Request Body

{
  "group": {
    "name": "Updated Group"
  }
}

json

application/json

Example Responses

{
  "id": "484282303676155430",
  "name": "Updated Group",
  "row_order": 1,
  "report_type": null,
  "created_at": "2026-04-13T08:06:56.627Z",
  "updated_at": "2026-04-13T08:06:56.649Z",
  "tasks": [
    {
      "id": "484282303677204007",
      "administration_id": 123,
      "name": "Task #2",
      "description": "Description 2",
      "row_order": 0,
      "completed_at": null,
      "report_type": null,
      "task_lists_group_id": "484282303676155430",
      "parent_task_id": null,
      "created_at": "2026-04-13T08:06:56.628Z",
      "updated_at": "2026-04-13T08:06:56.628Z",
      "assignee_id": null,
      "subtasks": [],
      "notes": [],
      "events": [
        {
          "administration_id": 123,
          "user_id": "484282135833740389",
          "action": "task_lists_task_created",
          "link_entity_id": null,
          "link_entity_type": null,
          "data": {},
          "created_at": "2026-04-13T08:06:56.629Z",
          "updated_at": "2026-04-13T08:06:56.629Z"
        }
      ]
    }
  ]
}

json

application/json

Creates a new task in a group

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_groups/{task_list_group_id}/tasks{format}

Creates a new task in the specified task list group.

Creates a new task in a group › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_group_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a new task in a group › Request Body

object

Creates a new task in a group › Responses

Task created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

POST/{administration_id}/task_list_groups/{task_list_group_id}/tasks{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/task_list_groups/:task_list_group_id/tasks:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": {
    "name": "New Task"
  }
}
'

shell

Example Request Body

{
  "task": {
    "name": "New Task"
  }
}

json

application/json

Example Responses

{
  "id": "484282303426594303",
  "administration_id": 123,
  "name": "New Task",
  "description": null,
  "row_order": 1,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "484282303397234172",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:06:56.388Z",
  "updated_at": "2026-04-13T08:06:56.388Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:06:56.390Z",
      "updated_at": "2026-04-13T08:06:56.390Z"
    }
  ]
}

json

application/json

Returns information about a task

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{id}{format}

Returns information about a task, including its subtasks, notes, and events.

Returns information about a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Returns information about a task › Responses

A task

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

GET/{administration_id}/task_list_tasks/{id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:id:format

shell

Example Responses

{
  "id": "484282325398455833",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "484282325397407256",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:07:17.343Z",
  "updated_at": "2026-04-13T08:07:17.343Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:17.344Z",
      "updated_at": "2026-04-13T08:07:17.344Z"
    }
  ]
}

json

application/json

Deletes a task

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{id}{format}

Permanently deletes a task and all its subtasks. Generated tasks cannot be deleted.

Deletes a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Deletes a task › Responses

Task deleted

No data returned

Updates a task

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{id}{format}

Updates a task's attributes.

Updates a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Updates a task › Request Body

object

Updates a task › Responses

Task updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

PATCH/{administration_id}/task_list_tasks/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": {
    "name": "Updated Task"
  }
}
'

shell

Example Request Body

{
  "task": {
    "name": "Updated Task"
  }
}

json

application/json

Example Responses

{
  "id": "484282326189082250",
  "administration_id": 123,
  "name": "Updated Task",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "484282326188033673",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:07:18.096Z",
  "updated_at": "2026-04-13T08:07:18.115Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:18.098Z",
      "updated_at": "2026-04-13T08:07:18.098Z"
    },
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_name",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "name": "Updated Task"
      },
      "created_at": "2026-04-13T08:07:18.116Z",
      "updated_at": "2026-04-13T08:07:18.116Z"
    }
  ]
}

json

application/json

Assigns a user to a task

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

Assigns a user to the specified task.

Assigns a user to a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Assigns a user to a task › Request Body

assignee_id

string | integer · pattern: ^\d+$ · required

The ID of the user to assign to the task. A user must have permissions to a task or else a 404 will be thrown.

Assigns a user to a task › Responses

User assigned to task

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

POST/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/assignment:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "assignee_id": "484282135855760486"
}
'

shell

Example Request Body

{
  "assignee_id": "484282135855760486"
}

json

application/json

Example Responses

{
  "id": "484282325979367028",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "484282325978318451",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:07:17.896Z",
  "updated_at": "2026-04-13T08:07:17.896Z",
  "assignee_id": "484282135855760486",
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:17.898Z",
      "updated_at": "2026-04-13T08:07:17.898Z"
    },
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_assigned",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "assignee": "Mo Neybird"
      },
      "created_at": "2026-04-13T08:07:17.924Z",
      "updated_at": "2026-04-13T08:07:17.924Z"
    }
  ]
}

json

application/json

Unassigns the user from a task

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

Removes the current assignment from the specified task.

Unassigns the user from a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Unassigns the user from a task › Responses

User unassigned from task

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

DELETE/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/assignment:format

shell

Example Responses

{
  "id": "484282326102050432",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "484282326101001855",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:07:18.013Z",
  "updated_at": "2026-04-13T08:07:18.013Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:18.015Z",
      "updated_at": "2026-04-13T08:07:18.015Z"
    }
  ]
}

json

application/json

Completes a task

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

Marks a task and all its subtasks as completed.

Completes a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Completes a task › Responses

Task completed

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

POST/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/completion:format

shell

Example Responses

{
  "id": "484282325269480969",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": "2026-04-13T08:07:17.239Z",
  "report_type": null,
  "task_lists_group_id": "484282325268432392",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:07:17.219Z",
  "updated_at": "2026-04-13T08:07:17.239Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:17.221Z",
      "updated_at": "2026-04-13T08:07:17.221Z"
    },
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_completed",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:17.241Z",
      "updated_at": "2026-04-13T08:07:17.241Z"
    }
  ]
}

json

application/json

Reopens a task

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

Reopens a completed task and possible parent tasks.

Reopens a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Reopens a task › Responses

Task reopened

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

string | integer · pattern: ^\d+$

A unique record identifier

parent_task_id

string | integer | null · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

created_at

string · date-time

updated_at

string · date-time

subtasks

array · task_list_task_response (circular)

object[]

DELETE/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/completion:format

shell

Example Responses

{
  "id": "484282326356854432",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "484282326355805855",
  "parent_task_id": null,
  "created_at": "2026-04-13T08:07:18.256Z",
  "updated_at": "2026-04-13T08:07:18.278Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:18.258Z",
      "updated_at": "2026-04-13T08:07:18.258Z"
    },
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_completed",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:18.266Z",
      "updated_at": "2026-04-13T08:07:18.266Z"
    },
    {
      "administration_id": 123,
      "user_id": "484282135833740389",
      "action": "task_lists_task_reopened",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-04-13T08:07:18.280Z",
      "updated_at": "2026-04-13T08:07:18.280Z"
    }
  ]
}

json

application/json

Creates a note on a task

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/notes{format}

Creates a new note on the specified task.

Creates a note on a task › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a note on a task › Request Body

object

Creates a note on a task › Responses

Note created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

entity_id

string | integer | null · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

string | integer · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

string | integer | null · pattern: ^\d+$

A unique record identifier

todo_type

string | null · enum

Enum values:

sales_invoice_due

purchase_invoice_due

general_document_reminder

general_document_due

new_document_awaiting_processing

new_financial_mutation_awaiting_processing

financial_mutations_not_updated

sales_invoice_payment_not_linked_to_financial_mutation

data

object | null

created_at

string · date-time

updated_at

string · date-time

POST/{administration_id}/task_list_tasks/{task_list_task_id}/notes{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/notes:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": {
    "note": "Test note",
    "todo": false
  }
}
'

shell

Example Request Body

{
  "note": {
    "note": "Test note",
    "todo": false
  }
}

json

application/json

Example Responses

{
  "id": "484282325201323519",
  "administration_id": 123,
  "entity_id": "484282325183497725",
  "entity_type": "TaskLists::Task",
  "user_id": "484282135833740389",
  "assignee_id": null,
  "todo": false,
  "note": "Test note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-04-13T08:07:17.154Z",
  "updated_at": "2026-04-13T08:07:17.154Z"
}

json

application/json

Creates a task list from a template

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{task_list_template_id}/task_lists{format}

Creates a new task list based on the specified template.

Creates a task list from a template › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_template_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a task list from a template › Request Body optional

object

Creates a task list from a template › Responses

Task list created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

string | integer | null · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

string · date-time

updated_at

string · date-time

object[]

POST/{administration_id}/task_list_templates/{task_list_template_id}/task_lists{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/task_list_templates/:task_list_template_id/task_lists:format \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "484282172666021755",
  "administration_id": 123,
  "name": "Task list template #1",
  "description": "Template description",
  "deadline_on": null,
  "period_begin": "2026-03-01",
  "period_end": "2026-03-31",
  "completed": false,
  "template_id": "484282172572698486",
  "total_tasks_count": 1,
  "completed_tasks_count": 0,
  "created_at": "2026-04-13T08:04:51.684Z",
  "updated_at": "2026-04-13T08:04:51.684Z",
  "groups": [
    {
      "id": "484282172669167485",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:04:51.688Z",
      "updated_at": "2026-04-13T08:04:51.688Z",
      "tasks": [
        {
          "id": "484282172670216062",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "484282172669167485",
          "parent_task_id": null,
          "created_at": "2026-04-13T08:04:51.690Z",
          "updated_at": "2026-04-13T08:04:51.690Z",
          "assignee_id": null,
          "subtasks": [],
          "notes": [],
          "events": [
            {
              "administration_id": 123,
              "user_id": "484282135833740389",
              "action": "task_lists_task_created",
              "link_entity_id": null,
              "link_entity_type": null,
              "data": {},
              "created_at": "2026-04-13T08:04:51.691Z",
              "updated_at": "2026-04-13T08:04:51.691Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Returns information about a task list

GET

https://moneybird.com/api/v2

/{administration_id}/task_lists/{id}{format}

Returns information about a task list, including its groups, tasks, and subtasks.

Returns information about a task list › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Returns information about a task list › Responses

A task list

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

string | integer | null · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

string · date-time

updated_at

string · date-time

object[]

GET/{administration_id}/task_lists/{id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/task_lists/:id:format

shell

Example Responses

{
  "id": "484282338709079566",
  "administration_id": 123,
  "name": "Task list #1",
  "description": "List description",
  "deadline_on": null,
  "period_begin": "2026-01-01",
  "period_end": "2026-03-31",
  "completed": false,
  "template_id": null,
  "total_tasks_count": 1,
  "completed_tasks_count": 0,
  "created_at": "2026-04-13T08:07:30.036Z",
  "updated_at": "2026-04-13T08:07:30.036Z",
  "groups": [
    {
      "id": "484282338712225296",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:07:30.040Z",
      "updated_at": "2026-04-13T08:07:30.040Z",
      "tasks": [
        {
          "id": "484282338713273873",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "484282338712225296",
          "parent_task_id": null,
          "created_at": "2026-04-13T08:07:30.041Z",
          "updated_at": "2026-04-13T08:07:30.041Z",
          "assignee_id": null,
          "subtasks": [],
          "notes": [],
          "events": [
            {
              "administration_id": 123,
              "user_id": "484282135833740389",
              "action": "task_lists_task_created",
              "link_entity_id": null,
              "link_entity_type": null,
              "data": {},
              "created_at": "2026-04-13T08:07:30.042Z",
              "updated_at": "2026-04-13T08:07:30.042Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Deletes a task list

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_lists/{id}{format}

Permanently deletes a task list and all its groups and tasks.

Deletes a task list › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Deletes a task list › Responses

Task list deleted

No data returned

Updates a task list

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_lists/{id}{format}

Updates a task list's name, description, or deadline.

Updates a task list › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Updates a task list › Request Body

object

Updates a task list › Responses

Task list updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

string | integer | null · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

string · date-time

updated_at

string · date-time

object[]

PATCH/{administration_id}/task_lists/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/task_lists/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_list": {
    "name": "Updated Name"
  }
}
'

shell

Example Request Body

{
  "task_list": {
    "name": "Updated Name"
  }
}

json

application/json

Example Responses

{
  "id": "484282338828617245",
  "administration_id": 123,
  "name": "Updated Name",
  "description": "List description",
  "deadline_on": null,
  "period_begin": "2026-01-01",
  "period_end": "2026-03-31",
  "completed": false,
  "template_id": null,
  "total_tasks_count": 1,
  "completed_tasks_count": 0,
  "created_at": "2026-04-13T08:07:30.150Z",
  "updated_at": "2026-04-13T08:07:30.169Z",
  "groups": [
    {
      "id": "484282338831762975",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:07:30.154Z",
      "updated_at": "2026-04-13T08:07:30.154Z",
      "tasks": [
        {
          "id": "484282338832811552",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "484282338831762975",
          "parent_task_id": null,
          "created_at": "2026-04-13T08:07:30.155Z",
          "updated_at": "2026-04-13T08:07:30.155Z",
          "assignee_id": null,
          "subtasks": [],
          "notes": [],
          "events": [
            {
              "administration_id": 123,
              "user_id": "484282135833740389",
              "action": "task_lists_task_created",
              "link_entity_id": null,
              "link_entity_type": null,
              "data": {},
              "created_at": "2026-04-13T08:07:30.156Z",
              "updated_at": "2026-04-13T08:07:30.156Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Creates a new group in a task list

POST

https://moneybird.com/api/v2

/{administration_id}/task_lists/{task_list_id}/groups{format}

Creates a new group in the specified task list.

Creates a new group in a task list › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a new group in a task list › Request Body

object

Creates a new group in a task list › Responses

Group created

id

string | integer · pattern: ^\d+$

A unique record identifier

name

string | null

row_order

integer

report_type

string | null

created_at

string · date-time

updated_at

string · date-time

object[]

List all task lists of an administration

GET

https://moneybird.com/api/v2

/{administration_id}/task_lists{format}

Returns a paginated list of task lists in the administration. Each page contains 30 task lists by default. Use the page parameter to fetch the next page.

List all task lists of an administration › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all task lists of an administration › query Parameters

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Amount of task lists per page, default: 30

page

integer | string

The page to fetch, starting at 1.

List all task lists of an administration › Responses

A list of task lists

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

string | integer | null · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

string · date-time

updated_at

string · date-time

object[]

GET/{administration_id}/task_lists{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/task_lists:format

shell

Example Responses

[
  {
    "id": "484282338057913791",
    "administration_id": 123,
    "name": "Task list #1",
    "description": "List description",
    "deadline_on": null,
    "period_begin": "2026-01-01",
    "period_end": "2026-03-31",
    "completed": false,
    "template_id": null,
    "total_tasks_count": 1,
    "completed_tasks_count": 0,
    "created_at": "2026-04-13T08:07:29.415Z",
    "updated_at": "2026-04-13T08:07:29.415Z",
    "groups": [
      {
        "id": "484282338061059521",
        "name": "Task list group #1",
        "row_order": 0,
        "report_type": null,
        "created_at": "2026-04-13T08:07:29.419Z",
        "updated_at": "2026-04-13T08:07:29.419Z",
        "tasks": [
          {
            "id": "484282338062108098",
            "administration_id": 123,
            "name": "Task #1",
            "description": "Description 1",
            "row_order": 0,
            "completed_at": null,
            "report_type": null,
            "task_lists_group_id": "484282338061059521",
            "parent_task_id": null,
            "created_at": "2026-04-13T08:07:29.420Z",
            "updated_at": "2026-04-13T08:07:29.420Z",
            "assignee_id": null,
            "subtasks": [],
            "notes": [],
            "events": [
              {
                "administration_id": 123,
                "user_id": "484282135833740389",
                "action": "task_lists_task_created",
                "link_entity_id": null,
                "link_entity_type": null,
                "data": {},
                "created_at": "2026-04-13T08:07:29.422Z",
                "updated_at": "2026-04-13T08:07:29.422Z"
              }
            ]
          }
        ]
      }
    ]
  }
]

json

application/json

Creates a new task list

POST

https://moneybird.com/api/v2

/{administration_id}/task_lists{format}

Creates a new task list. Optionally, you can provide a template_id to create the task list from a template.

Creates a new task list › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a new task list › Request Body

object

Creates a new task list › Responses

Task list created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

string | integer | null · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

string · date-time

updated_at

string · date-time

object[]

POST/{administration_id}/task_lists{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/task_lists:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_list": {
    "name": "New Task List"
  }
}
'

shell

Example Request Body

{
  "task_list": {
    "name": "New Task List"
  }
}

json

application/json

Example Responses

{
  "id": "484282338572764668",
  "administration_id": 123,
  "name": "New Task List",
  "description": null,
  "deadline_on": null,
  "period_begin": "2026-03-01",
  "period_end": "2026-03-31",
  "completed": true,
  "template_id": null,
  "total_tasks_count": 0,
  "completed_tasks_count": 0,
  "created_at": "2026-04-13T08:07:29.906Z",
  "updated_at": "2026-04-13T08:07:29.906Z",
  "groups": [
    {
      "id": "484282338576958974",
      "name": null,
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:07:29.910Z",
      "updated_at": "2026-04-13T08:07:29.910Z",
      "tasks": []
    }
  ]
}

json

application/json

Subscriptions Task list templates