Kanban Tool (Preview)
Kanban Tool is an intuitive project management service for real-time collaboration. By splitting work into stages, e.g. To do - Doing - Done, teams get a visual representation of the process and status of all tasks. Unlimited boards with swimlanes and WIP limits. In-depth customization of the layout, card template, and process automation. Task assignments and comments. Seamless time tracking & reporting. iOS and Android apps and much more!
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Kanban Tool Support |
| URL | https://kanbantool.com/support/introduction |
| support@kanbantool.com |
| Connector Metadata | |
|---|---|
| Publisher | Shore Labs |
| Website | https://kanbantool.com/ |
| Privacy policy | https://kanbantool.com/policy/privacy |
| Categories | Business Management;Collaboration |
Prerequisites
To use the connector, you must create a Kanban Tool account. To do that, please visit Kanban Tool.
How to get credentials?
You can generate an API token in your Kanban Tool profile settings.
From the dashboard view, click on your name in the top-right corner, and go to My Profile -> API Access -> Enable API Access.
[Where do I get my API token] (https://kanbantool.com/support/integrations#where-do-i-get-my-api-token)
Known issues and limitations
Version 1.0 only supports tasks' default fields.
FAQ
In case of any questions, visit our support page or contact us at support@kanbantool.com.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Subdomain | string | The subdomain of the account | True |
| API Key | securestring | The API Key for this API | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Archive a task |
This operation archives a task. |
| Create a comment |
This operation creates a comment. |
| Create a subtask |
This operation creates a subtask. |
| Create a task |
This operation creates a task. |
| Delete a subtask |
This operation deletes a subtask. |
| Delete task |
This operation deletes a task. |
| Get board |
This operation gets board's details. |
| Get board activities |
This operation gets a board activities. |
| Get boards |
This operation gets boards. |
| Get comments |
This operation gets a task comments. |
| Get subtasks |
This operation gets subtasks. |
| Get task |
This operation gets a task. |
| Get tasks |
This operation gets tasks. |
| Move a task |
This operation moves a task. |
| Update a subtask |
This operation updates a subtask. |
| Update a task |
This operation updates a task. |
Archive a task
This operation archives a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
task
|
task | GetTaskResponse |
Create a comment
This operation creates a comment.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
|
Comment content
|
content | True | string |
Content of a comment. |
Returns
- Body
- GetCommentResponse
Create a subtask
This operation creates a subtask.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
|
Subtask name
|
name | True | string |
Name of a subtask. |
|
Assigned user
|
assigned_user_id | string |
ID of assigned user. |
Returns
- Body
- GetSubtaskResponse
Create a task
This operation creates a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task name
|
name | True | string |
Name of a task. |
|
Task description
|
description | string |
Description of a task. |
|
|
Swimlane
|
swimlane_id | string |
Swimlane ID |
|
|
Workflow stage
|
workflow_stage_id | string |
Workflow stage ID |
|
|
Card type
|
card_type_id | string |
Card type ID |
|
|
Assigned user
|
assigned_user_id | string |
ID of assigned user. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
task
|
task | GetTaskResponse |
Delete a subtask
This operation deletes a subtask.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
|
Subtask ID
|
subtask_id | True | string |
Unique ID of the subtask. |
Returns
- Body
- GetSubtaskResponse
Delete task
This operation deletes a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
task
|
task | GetTaskResponse |
Get board
This operation gets board's details.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
Returns
- Body
- GetBoardResponse
Get board activities
This operation gets a board activities.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
Returns
- Items
- GetActivitiesResponse
Get boards
Get comments
This operation gets a task comments.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
Returns
- Items
- GetCommentsResponse
Get subtasks
This operation gets subtasks.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
Returns
- Items
- GetSubtasksResponse
Get task
This operation gets a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
task
|
task | GetTaskResponse |
Get tasks
This operation gets tasks.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
Returns
- Items
- GetTasksResponse
Move a task
This operation moves a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
|
Direction
|
direction | string |
Direction to move. |
|
|
Swimlane
|
swimlane_id | string |
Swimlane ID |
|
|
Workflow stage
|
workflow_stage_id | string |
Workflow stage ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
task
|
task | GetTaskResponse |
Update a subtask
This operation updates a subtask.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
|
Subtask ID
|
subtask_id | True | string |
Unique ID of the subtask. |
|
Subtask name
|
name | string |
Name of a subtask. |
|
|
Is completed
|
is_completed | boolean |
Is completed |
|
|
Assigned user
|
assigned_user_id | string |
ID of assigned user. |
Returns
- Body
- GetSubtaskResponse
Update a task
This operation updates a task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Board ID
|
board_id | True | string |
Unique ID of the board. |
|
Task ID
|
task_id | True | string |
Unique ID of the task. |
|
Task name
|
name | string |
Name of a task. |
|
|
Task description
|
description | string |
Description of a task. |
|
|
Card type
|
card_type_id | string |
Card type ID |
|
|
Assigned user
|
assigned_user_id | string |
ID of assigned user. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
task
|
task | GetTaskResponse |
Definitions
GetBoardsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
GetBoardResponse |
GetBoardResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
board.id | integer |
Board's ID |
|
Name
|
board.name | string |
Board's name |
|
Description
|
board.description | string |
Board's description |
|
Position
|
board.position | integer |
Board's position |
|
Version
|
board.version | integer |
Board's version |
|
Created at
|
board.created_at | string |
Created at |
|
Updated at
|
board.updated_at | string |
Updated at |
|
Settings updated at
|
board.settings_updated_at | string |
Settings update date |
|
Account ID
|
board.account_id | integer |
Board's account ID |
|
Folder ID
|
board.folder_id | integer |
Board's folder ID |
|
Last activity on
|
board.last_activity_on | string |
Board's last activity date |
|
Deleted at
|
board.deleted_at | string |
Board's delete date |
|
External ID sequence
|
board.external_id_sequence | integer |
External ID sequence |
|
Template ID
|
board.board_template_id | string |
Board's template ID |
|
Cumulative flow updated at
|
board.cumulative_flow_updated_at | string |
Cumulative flow updated at |
|
Owner ID
|
board.owner_id | integer |
Board's owner ID |
|
workflow_stages
|
board.workflow_stages | array of object | |
|
ID
|
board.workflow_stages.id | integer |
Workflow stage ID |
|
Board ID
|
board.workflow_stages.board_id | integer |
Board ID |
|
Name
|
board.workflow_stages.name | string |
Name |
|
Full name
|
board.workflow_stages.full_name | string |
Full name |
|
swimlanes
|
board.swimlanes | array of object | |
|
ID
|
board.swimlanes.id | integer |
Swimlane ID |
|
Board ID
|
board.swimlanes.board_id | integer |
Board ID |
|
Name
|
board.swimlanes.name | string |
Name |
|
card_types
|
board.card_types | array of object | |
|
ID
|
board.card_types.id | integer |
Card type ID |
|
Board ID
|
board.card_types.board_id | integer |
Board ID |
|
Name
|
board.card_types.name | string |
Name |
GetTasksResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
GetTaskResponse |
GetTaskResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | integer |
Task ID |
|
Name
|
name | string |
Task name |
|
Board ID
|
board_id | integer |
Board ID |
|
Workflow stage ID
|
workflow_stage_id | integer |
Workflow stage ID |
|
Swimlane ID
|
swimlane_id | integer |
Swimlane ID |
|
Deleted at
|
deleted_at | string |
Deleted at |
|
Recurring schedule
|
recurring_schedule | string |
Tasks's recurring schedule |
|
Description
|
description | string |
Tasks's description |
|
Position
|
position | integer |
Task's position |
|
Priority
|
priority | integer |
Task's priority |
|
Tags
|
tags | string |
Tasks's tags |
|
Created at
|
created_at | string |
Created at |
|
Updated at
|
updated_at | string |
Updated at |
|
Board version
|
board_version | integer |
Board's version |
|
Archived at
|
archived_at | string |
Archived at |
|
Assigned user ID
|
assigned_user_id | integer |
Assigned user ID |
|
Comments count
|
comments_count | integer |
Comments count |
|
Size estimate
|
size_estimate | string |
Task's size estimate |
|
Card type ID
|
card_type_id | integer |
Card type ID |
|
Subtasks count
|
subtasks_count | integer |
Subtasks count |
|
Subtasks completed count
|
subtasks_completed_count | integer |
Subtasks completed count |
|
Attachments count
|
attachments_count | integer |
Attachments count |
|
Custom field 1
|
custom_field_1 | string |
Custom field 1 |
|
Custom field 2
|
custom_field_2 | string |
Custom field 2 |
|
Custom field 3
|
custom_field_3 | string |
Custom field 3 |
|
Custom field 4
|
custom_field_4 | string |
Custom field 4 |
|
Custom field 5
|
custom_field_5 | string |
Custom field 5 |
|
Custom field 6
|
custom_field_6 | string |
Custom field 6 |
|
Custom field 7
|
custom_field_7 | string |
Custom field 7 |
|
Custom field 8
|
custom_field_8 | string |
Custom field 8 |
|
Custom field 9
|
custom_field_9 | string |
Custom field 9 |
|
Custom field 10
|
custom_field_10 | string |
Custom field 10 |
|
Custom field 11
|
custom_field_11 | string |
Custom field 11 |
|
Custom field 12
|
custom_field_12 | string |
Custom field 12 |
|
Custom field 13
|
custom_field_13 | string |
Custom field 13 |
|
Custom field 14
|
custom_field_14 | string |
Custom field 14 |
|
Custom field 15
|
custom_field_15 | string |
Custom field 15 |
|
External link
|
external_link | string |
External link |
|
Due date
|
due_date | string |
Due date |
|
Postponed until
|
postponed_until | string |
Postponed until |
|
External ID
|
external_id | string |
External ID |
|
Subtask search tags
|
subtask_search_tags | string |
Subtask search tags |
|
Block reason
|
block_reason | string |
Block reason |
|
Created by ID
|
created_by_id | integer |
Created by ID |
|
Time estimate
|
time_estimate | integer |
Time estimate |
|
Timers total
|
timers_total | string |
Timers total |
|
Timers total updated at
|
timers_total_updated_at | string |
Timers total updated at |
|
Timers active count
|
timers_active_count | integer |
Timers active count |
|
Timers listed count
|
timers_listed_count | integer |
Timers listed count |
|
Timers postponed count
|
timers_postponed_count | integer |
Timers postponed count |
|
Linked tasks
|
linked_tasks | string |
Linked tasks |
|
Linked tasks status
|
linked_tasks_status | string |
Linked tasks status |
|
Linked from
|
linked_from | string |
Linked from |
GetActivitiesResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
changelog.id | integer |
Changelog's ID |
|
Board ID
|
changelog.board_id | integer |
Board's ID |
|
What
|
changelog.what | string |
Type of changelog |
|
Changed object ID
|
changelog.changed_object_id | integer |
Changed object ID |
|
Changed object type
|
changelog.changed_object_type | string |
Changed object type |
|
Changed object version
|
changelog.changed_object_version | integer |
Changed object version |
|
Created at
|
changelog.created_at | string |
Created date of changelog |
|
User ID
|
changelog.user_id | integer |
User ID |
|
Workflow stage ID
|
changelog.workflow_stage_id | integer |
Workflow stage ID |
|
Swimlane ID
|
changelog.swimlane_id | integer |
Swimlane ID |
|
Description
|
changelog.description | string |
Changelog's description |
|
User ID
|
changelog.data.user_id | integer |
User ID |
|
User initials
|
changelog.data.user_initials | string |
User initials |
|
Workflow stage ID
|
changelog.data.workflow_stage_id | integer |
Workflow stage ID |
|
Workflow stage name
|
changelog.data.workflow_stage_name | string |
Workflow stage name |
|
Swimlane ID
|
changelog.data.swimlane_id | integer |
Swimlane ID |
|
Swimlane name
|
changelog.data.swimlane_name | string |
Swimlane name |
|
Task ID
|
changelog.data.task_id | integer |
Task ID |
|
Task name
|
changelog.data.task_name | string |
Task name |
|
Task external ID
|
changelog.data.task_external_id | string |
Task external ID |
|
Dependent task ID
|
changelog.data.dependent_task_id | integer |
Dependent task ID |
|
Dependent task name
|
changelog.data.dependent_task_name | string |
Dependent task name |
|
From workflow stage ID
|
changelog.data.from_workflow_stage_id | integer |
From workflow stage ID |
|
From workflow stage name
|
changelog.data.from_workflow_stage_name | string |
From workflow stage name |
|
From swimlane ID
|
changelog.data.from_swimlane_id | integer |
From swimlane ID |
|
From swimlane name
|
changelog.data.from_swimlane_name | string |
From swimlane name |
|
To workflow stage ID
|
changelog.data.to_workflow_stage_id | integer |
To workflow stage ID |
|
To workflow stage name
|
changelog.data.to_workflow_stage_name | string |
To workflow stage name |
|
To swimlane ID
|
changelog.data.to_swimlane_id | integer |
To swimlane ID |
|
To swimlane name
|
changelog.data.to_swimlane_name | string |
To swimlane name |
|
Comment ID
|
changelog.data.comment_id | integer |
Comment ID |
|
Comment content
|
changelog.data.comment_content | string |
Comment content |
|
Subtask ID
|
changelog.data.subtask_id | integer |
Subtask ID |
|
Subtask name
|
changelog.data.subtask_name | string |
Subtask name |
|
Changes
|
changelog.data.changes | array of string |
Changes |
|
Values
|
changelog.data.values | array of string |
Values |
GetCommentsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
GetCommentResponse |
GetCommentResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
comment.id | integer |
Comment's ID |
|
User ID
|
comment.user_id | integer |
User ID |
|
Commentable version
|
comment.commentable_version | integer |
Commentable version |
|
Content
|
comment.content | string |
Comment content |
|
Created at
|
comment.created_at | string |
Comment's created at |
|
Updated at
|
comment.updated_at | string |
Updated at |
|
Deleted at
|
comment.deleted_at | string |
Deleted at |
|
Recipients
|
comment.recipients | string |
Comment's recipients |
|
attachments
|
comment.attachments | array of object | |
|
ID
|
comment.attachments.id | integer |
Attachment's ID |
|
Name
|
comment.attachments.name | string |
Attachment's name |
|
Content type
|
comment.attachments.content_type | string |
Content type |
|
Size
|
comment.attachments.size | integer |
Size |
|
Data
|
comment.attachments.data | string |
Data |
|
Created at
|
comment.attachments.created_at | string |
Created at |
|
Url
|
comment.attachments.url | string |
Url |
GetSubtasksResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
GetSubtaskResponse |
GetSubtaskResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
subtask.id | integer |
Subtask's ID |
|
Task version
|
subtask.task_version | integer |
Task version |
|
Task ID
|
subtask.task_id | integer |
Task ID |
|
Created by ID
|
subtask.created_by_id | integer |
Created by ID |
|
Name
|
subtask.name | string |
Subtask's name |
|
Position
|
subtask.position | integer |
Position |
|
Assigned user ID
|
subtask.assigned_user_id | integer |
Assigned user ID |
|
Is completed
|
subtask.is_completed | boolean |
Is completed |
|
Created at
|
subtask.created_at | string |
Created at |
|
Updated at
|
subtask.updated_at | string |
Updated at |
|
Deleted at
|
subtask.deleted_at | string |
Deleted at |