Task list templates

Endpointhttps://moneybird.com/api/v2

Task list templates are reusable blueprints for creating task lists with predefined groups and tasks.

Returns information about a task list template

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{id}{format}

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

Returns information about a task list template › 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 template › Responses

A task list template

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

GET/{administration_id}/task_list_templates/{id}{format}

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

shell

Example Responses

{
  "id": "484282173210232736",
  "administration_id": 123,
  "name": "Task list template #1",
  "description": "Template description",
  "period": "P1M",
  "deadline_after": null,
  "created_at": "2026-04-13T08:04:52.204Z",
  "updated_at": "2026-04-13T08:04:52.204Z",
  "groups": [
    {
      "id": "484282173214427042",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:04:52.209Z",
      "updated_at": "2026-04-13T08:04:52.209Z",
      "tasks": [
        {
          "id": "484282173215475619",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "484282173214427042",
          "parent_task_id": null,
          "created_at": "2026-04-13T08:04:52.210Z",
          "updated_at": "2026-04-13T08:04:52.210Z",
          "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:52.211Z",
              "updated_at": "2026-04-13T08:04:52.211Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Deletes a task list template

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{id}{format}

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

Deletes a task list template › 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 template › Responses

Template deleted

No data returned

Updates a task list template

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{id}{format}

Updates a task list template.

Updates a task list template › 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 template › Request Body

object

Updates a task list template › Responses

Template 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

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

PATCH/{administration_id}/task_list_templates/{id}{format}

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

shell

Example Request Body

{
  "task_list_template": {
    "name": "Updated Template"
  }
}

json

application/json

Example Responses

{
  "id": "484282173911730126",
  "administration_id": 123,
  "name": "Updated Template",
  "description": "Template description",
  "period": "P1M",
  "deadline_after": null,
  "created_at": "2026-04-13T08:04:52.872Z",
  "updated_at": "2026-04-13T08:04:52.911Z",
  "groups": [
    {
      "id": "484282173915924432",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:04:52.877Z",
      "updated_at": "2026-04-13T08:04:52.877Z",
      "tasks": [
        {
          "id": "484282173916973009",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "484282173915924432",
          "parent_task_id": null,
          "created_at": "2026-04-13T08:04:52.878Z",
          "updated_at": "2026-04-13T08:04:52.878Z",
          "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:52.880Z",
              "updated_at": "2026-04-13T08:04:52.880Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Creates a new group in a task list template

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{task_list_template_id}/groups{format}

Creates a new group in the specified task list template.

Creates a new group in a task list 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 new group in a task list template › Request Body

object

Creates a new group in a task list template › 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 list templates of an administration

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_templates{format}

Returns all task list templates in the administration.

List all task list templates 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 list templates of an administration › Responses

200

A list of task list templates

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

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

GET/{administration_id}/task_list_templates{format}

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

shell

Example Responses

[
  {
    "id": "484282172959623055",
    "administration_id": 123,
    "name": "Task list template #1",
    "description": "Template description",
    "period": "P1M",
    "deadline_after": null,
    "created_at": "2026-04-13T08:04:51.964Z",
    "updated_at": "2026-04-13T08:04:51.964Z",
    "groups": [
      {
        "id": "484282172963817361",
        "name": "Task list group #1",
        "row_order": 0,
        "report_type": null,
        "created_at": "2026-04-13T08:04:51.969Z",
        "updated_at": "2026-04-13T08:04:51.969Z",
        "tasks": [
          {
            "id": "484282172964865938",
            "administration_id": 123,
            "name": "Task #1",
            "description": "Description 1",
            "row_order": 0,
            "completed_at": null,
            "report_type": null,
            "task_lists_group_id": "484282172963817361",
            "parent_task_id": null,
            "created_at": "2026-04-13T08:04:51.970Z",
            "updated_at": "2026-04-13T08:04:51.970Z",
            "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.972Z",
                "updated_at": "2026-04-13T08:04:51.972Z"
              }
            ]
          }
        ]
      }
    ]
  }
]

json

application/json

Creates a new task list template

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_templates{format}

Creates a new task list template.

Creates a new task list template › 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 template › Request Body

object

Creates a new task list template › Responses

Template 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

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

POST/{administration_id}/task_list_templates{format}

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

shell

Example Request Body

{
  "task_list_template": {
    "name": "New Template"
  }
}

json

application/json

Example Responses

{
  "id": "484282174207428579",
  "administration_id": 123,
  "name": "New Template",
  "description": null,
  "period": "P1M",
  "deadline_after": null,
  "created_at": "2026-04-13T08:04:53.156Z",
  "updated_at": "2026-04-13T08:04:53.156Z",
  "groups": [
    {
      "id": "484282174210574309",
      "name": null,
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-04-13T08:04:53.159Z",
      "updated_at": "2026-04-13T08:04:53.159Z",
      "tasks": []
    }
  ]
}

json

application/json

Task lists Tax rates

Returns information about a task list template

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{id}{format}

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

Returns information about a task list template › 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 template › Responses

A task list template

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

Deletes a task list template

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{id}{format}

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

Deletes a task list template › 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 template › Responses

Template deleted

No data returned

Updates a task list template

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{id}{format}

Updates a task list template.

Updates a task list template › 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 template › Request Body

object

Updates a task list template › Responses

Template 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

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

Creates a new group in a task list template

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{task_list_template_id}/groups{format}

Creates a new group in the specified task list template.

Creates a new group in a task list 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 new group in a task list template › Request Body

object

Creates a new group in a task list template › 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 list templates of an administration

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_templates{format}

Returns all task list templates in the administration.

List all task list templates 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 list templates of an administration › Responses

200

A list of task list templates

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

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]

Creates a new task list template

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_templates{format}

Creates a new task list template.

Creates a new task list template › 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 template › Request Body

object

Creates a new task list template › Responses

Template 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

period

string | null

ISO 8601 duration string (e.g. "P1M" for one month, "P3M" for one quarter, "P1Y" for one year)

deadline_after

string | null

ISO 8601 duration string representing the deadline offset from the period end

created_at

string · date-time

updated_at

string · date-time

object[]