Skip to main content
Motion logo
  • Category: productivity
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 27
  • Triggers: 0
  • Slug: MOTION
  • Version: 20261101_00

Tools

Slug: MOTION_ADD_CUSTOM_FIELD_TO_PROJECTTool to add a custom field value to a project in Motion. Use when you need to set or update custom field data on an existing project.

Input Parameters

object
required
The custom field value object containing the type and actual value to set.
string
required
The unique identifier of the project to add the custom field to. Typically starts with ‘pr_’.
string
required
The unique identifier of the custom field instance to add. This references the workspace custom field definition. Typically starts with ‘cfi_’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_ADD_CUSTOM_FIELD_TO_TASKTool to add a custom field value to a task in Motion. Use when you need to set or update custom field data on an existing task.

Input Parameters

object
required
The custom field value object containing the type and actual value to set.
string
required
The unique identifier of the task to add the custom field to. Typically starts with ‘tk_’.
string
required
The unique identifier of the custom field instance to add. This references the workspace custom field definition. Typically starts with ‘cfi_’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_CREATE_COMMENTTool to create a new comment on a Motion task. Use when you need to add a comment to an existing task.

Input Parameters

string
required
The task to comment on
string
Github Flavored Markdown comment

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_CREATE_CUSTOM_FIELDTool to create a new custom field in a Motion workspace. Use when you need to add custom fields like text, select options, dates, or other field types to customize your workspace. For select/multiSelect types, provide options in metadata.

Input Parameters

string
required
Name of the custom field
string ("text" | "url" | "date" | "person" | "multiPerson" | "phone" | "select" | "multiSelect" | "number" | "email" | "checkbox" | "relatedTo")
required
Type of the custom field. Must be one of: text, url, date, person, multiPerson, phone, select, multiSelect, number, email, checkbox, or relatedTo
object
Configuration metadata for advanced custom field types.
string
required
The workspace ID where the custom field will be created

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_CREATE_PROJECTTool to create a new project in Motion. Use when you need to create a project within a specific workspace. Projects can have optional due dates, descriptions (HTML supported), labels, and priority levels.

Input Parameters

string
required
The name of the project
array
List of label names the project should have
array
Array of stage objects for the project. Required when projectDefinitionId is provided.
string
ISO 8601 due date for the project
string ("ASAP" | "HIGH" | "MEDIUM" | "LOW")
Priority levels for Motion projects.
string
The description of the project. HTML input accepted.
string
required
The workspace ID to which the project belongs
string
Template ID for the project. When provided, must include stages array.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_CREATE_RECURRING_TASKTool to create a new recurring task in Motion. Use when you need to set up tasks that repeat on a schedule (daily, weekly, monthly, etc.). Recurring tasks automatically generate task instances based on the specified frequency pattern.

Input Parameters

string
required
Name of the recurring task
integer
Duration in minutes (must be integer greater than 0). Use this to specify how long the task should take. Do not set this for reminder-only tasks.
string ("HIGH" | "MEDIUM")
Priority levels for recurring tasks.
string
Adherence schedule for when the task can be scheduled. Defaults to ‘Work Hours’ if not specified.
string
required
Frequency pattern for task recurrence. Examples: ‘daily_every_day’, ‘daily_every_week_day’, ‘weekly_specific_days_[MO,FR]’, ‘monthly_1’, ‘monthly_first_monday’, ‘quarterly_first_day’. See Motion API frequency documentation for all patterns.
string
Preferred scheduling time in HH:mm format (24-hour time). Motion will try to schedule the task around this time.
string
required
User ID to assign the task to. Use the list_users action to get valid user IDs.
string
ISO 8601 date string for when the recurrence should start. Defaults to today if not specified.
string
Task description. HTML input is accepted.
string
required
The workspace ID where the recurring task will be created
string ("HARD" | "SOFT")
Deadline type for recurring tasks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_CREATE_TASKTool to create a new task in Motion. Use when you need to add a task to a workspace with specified properties like name, priority, due date, and assignee.

Input Parameters

string
required
The name of the task
array
List of label names to apply to the task. Labels must exist in the workspace.
string
Task status name. Must match a valid status in the workspace. Use ListStatuses action to get available statuses.
string
ISO 8601 formatted due date for the task (e.g., ‘2024-12-31T23:59:59Z’)
string
Duration in minutes (e.g., ‘60’ for 1 hour) or ‘REMINDER’ for a reminder-only task
string ("ASAP" | "HIGH" | "MEDIUM" | "LOW")
Priority levels for Motion tasks.
string
Project ID to associate the task with. The project must exist in the workspace.
string
User ID to assign the task to. The user must be a member of the workspace.
string
Task description in GitHub Flavored Markdown (GFM) format
string
required
The workspace ID where the task will be created

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_DELETE_CUSTOM_FIELDTool to delete a custom field from Motion workspace. Use when you need to remove a custom field that is no longer needed. This operation is permanent and cannot be undone.

Input Parameters

string
required
The custom field ID to delete
string
required
The workspace ID where the custom field exists

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_DELETE_CUSTOM_FIELD_FROM_PROJECTTool to delete a custom field value from a project in Motion. Use when you need to remove a custom field value from a specific project.

Input Parameters

string
required
The ID of the custom field value that will be deleted.
string
required
The project ID from which a custom field value will be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_DELETE_CUSTOM_FIELD_FROM_TASKTool to delete a custom field value from a task in Motion. Use when you need to remove a custom field value from a specific task by providing the task ID and custom field value ID.

Input Parameters

string
required
The unique identifier of the task from which to delete the custom field value.
string
required
The unique identifier of the custom field value to delete from the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_DELETE_RECURRING_TASKTool to delete a recurring task from Motion based on the ID supplied. Use when you need to remove a recurring task permanently from the system.

Input Parameters

string
required
ID of the recurring task to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_DELETE_TASKTool to delete a task from Motion based on task ID. Use when you need to permanently remove a task from the Motion workspace.

Input Parameters

string
required
The unique identifier of the task to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_GET_MY_USERTool to get information on the owner of the API key. Use when you need to retrieve the current user’s profile details including their ID, name, and email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_GET_PROJECTTool to retrieve a single project by its ID. Use when you need to get detailed information about a specific project including its name, description, status, and custom field values.

Input Parameters

string
required
The ID of the project to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_GET_TASKTool to retrieve a task by its ID from Motion. Returns complete task details including title, description, due date, priority, assignees, scheduling information, and custom fields.

Input Parameters

string
required
The id of the task to fetch

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_COMMENTSTool to get all comments on a specific task. Use when you need to retrieve comment history for a task. Supports cursor-based pagination for tasks with many comments.

Input Parameters

string
Use if a previous request returned a cursor. Will page through results. Pass the nextCursor value from the previous response to get the next page.
string
required
The ID of the task to get comments for. Required parameter to fetch all comments associated with a specific task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_CUSTOM_FIELDSTool to retrieve all custom fields for a given Motion workspace. Use when you need to see what custom fields are available in a workspace.

Input Parameters

string
required
The workspace ID to get custom fields from

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_PROJECTSList projects accessible to the API key, optionally filtered by workspace. Results are paginated; supply the returned cursor to retrieve the next page.

Input Parameters

string
Use if a previous request returned a cursor. Will page through results.
string
The workspace ID to get projects from. If not provided, returns projects from all workspaces accessible by the API key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_RECURRING_TASKSList recurring tasks in a Motion workspace. Results are paginated; use the returned cursor to retrieve subsequent pages.

Input Parameters

string
Cursor for pagination. Use the nextCursor value from a previous response to get the next page of results.
string
required
The workspace to get recurring tasks from. Required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_SCHEDULESTool to get a list of schedules for your user. Use when you need to retrieve the user’s scheduling configuration including work hours and timezone settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_STATUSESTool to get a list of statuses for a Motion workspace. Use when you need to retrieve available task statuses for a workspace.

Input Parameters

string
Get statuses for a particular workspace. If not provided, returns statuses for all workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_TASKSList Motion tasks with optional filters for assignee, project, workspace, status, label, or name. Results are paginated; use the returned cursor to retrieve subsequent pages.

Input Parameters

string
Filter tasks containing this string in their name. Performs a case-insensitive substring match on task names.
string
Limit tasks returned by label. Filter tasks that have this specific label attached.
string
Pagination cursor. Use if a previous request returned a nextCursor value in the meta field to fetch the next page of results.
array
Limit tasks by status array. Provide a list of status names to filter tasks with those specific statuses.
string
Limit tasks to a given project. Use the project’s ID to filter tasks belonging to that project.
string
Limit tasks returned to a specific assignee. Use the assignee’s user ID to filter tasks assigned to that person.
string
The workspace to get tasks from. Use the workspace ID to scope the task list to a specific workspace.
boolean
Include tasks with all statuses. Set to true to include tasks with any status, or false/omit to only include tasks with active statuses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_USERSTool to get a list of users for a given workspace or team. Use when you need to retrieve user information from Motion. Supports pagination via cursor and filtering by workspaceId or teamId.

Input Parameters

string
Use if a previous request returned a cursor. Will page through results. Pass the nextCursor value from the previous response to get the next page.
string
The ID of the team to filter users by. Filters results to return only users in the specified team.
string
The ID of the workspace to get users from. Filters results to return only users in the specified workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_LIST_WORKSPACESTool to retrieve all workspaces a user has access to. Use when you need to discover available workspaces, filter for specific workspace IDs, or paginate through workspace results. Returns workspace details including type, team, labels, and statuses.

Input Parameters

array
Array of workspace IDs to retrieve specific workspaces. If provided, only returns workspaces matching these IDs. If not provided, returns all workspaces the user has access to.
string
Pagination cursor to retrieve the next page of results. Use the nextCursor value from the previous response’s meta object to fetch more workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_MOVE_TASKTool to move a task to a different workspace in Motion. Use when you need to relocate a task from one workspace to another.

Input Parameters

string
required
The ID of the task to move
string
The user ID to assign the task to in the new workspace
string
required
The workspace ID to move the task to

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_UNASSIGN_TASKTool to unassign a task from its current assignee. Use when you need to remove the assignee from a task, leaving the task unassigned.

Input Parameters

string
required
The ID of the task to unassign from its current assignee

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MOTION_UPDATE_TASKTool to update an existing task in Motion. Use when you need to modify task properties like name, priority, due date, status, or assignee. Only provide the fields you want to update.

Input Parameters

string
required
The task ID to update
string
Task title
array
List of label names to apply to the task
string
Task status name. Must match a valid status in the workspace.
string
ISO 8601 due date for the task. Required for scheduled tasks.
string
Duration in minutes (>0), ‘NONE’ for no duration, or ‘REMINDER’ for reminder tasks
string ("ASAP" | "HIGH" | "MEDIUM" | "LOW")
Priority levels for Motion tasks.
string
Project ID to associate the task with
string
User ID to assign the task to
string
Task description in GitHub Flavored Markdown (GFM) format
object
Auto-scheduling configuration for a task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not