Motion

motion

Motion is an intelligent calendar and project management tool that automatically plans your day, schedules meetings, and helps teams collaborate efficiently.

Productivity Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (27)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add Custom Field to ProjectMOTION_ADD_CUSTOM_FIELD_TO_PROJECTAcción

Tool 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.

Parámetros de entrada

valueobjectObligatorio
The custom field value object containing the type and actual value to set.
projectIdstringObligatorio
The unique identifier of the project to add the custom field to. Typically starts with 'pr_'.
customFieldInstanceIdstringObligatorio
The unique identifier of the custom field instance to add. This references the workspace custom field definition. Typically starts with 'cfi_'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Add Custom Field to TaskMOTION_ADD_CUSTOM_FIELD_TO_TASKAcción

Tool 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.

Parámetros de entrada

valueobjectObligatorio
The custom field value object containing the type and actual value to set.
taskIdstringObligatorio
The unique identifier of the task to add the custom field to. Typically starts with 'tk_'.
customFieldInstanceIdstringObligatorio
The unique identifier of the custom field instance to add. This references the workspace custom field definition. Typically starts with 'cfi_'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create CommentMOTION_CREATE_COMMENTAcción

Tool to create a new comment on a Motion task. Use when you need to add a comment to an existing task.

Parámetros de entrada

taskIdstringObligatorio
The task to comment on
contentstring
Github Flavored Markdown comment

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Custom FieldMOTION_CREATE_CUSTOM_FIELDAcción

Tool 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.

Parámetros de entrada

namestringObligatorio
Name of the custom field
typestringObligatorioenum
Type of the custom field. Must be one of: text, url, date, person, multiPerson, phone, select, multiSelect, number, email, checkbox, or relatedTo
texturldatepersonmultiPersonphoneselectmultiSelectnumberemailcheckboxrelatedTo
metadataobject
Configuration metadata for advanced custom field types.
workspaceIdstringObligatorio
The workspace ID where the custom field will be created

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create ProjectMOTION_CREATE_PROJECTAcción

Tool 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.

Parámetros de entrada

namestringObligatorio
The name of the project
labelsstring[]
List of label names the project should have
stagesobject[]
Array of stage objects for the project. Required when projectDefinitionId is provided.
dueDatestring
ISO 8601 due date for the project
prioritystringenum
Priority levels for Motion projects.
ASAPHIGHMEDIUMLOW
descriptionstring
The description of the project. HTML input accepted.
workspaceIdstringObligatorio
The workspace ID to which the project belongs
projectDefinitionIdstring
Template ID for the project. When provided, must include stages array.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Recurring TaskMOTION_CREATE_RECURRING_TASKAcción

Tool 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.

Parámetros de entrada

namestringObligatorio
Name of the recurring task
durationinteger
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.
prioritystringenum
Priority levels for recurring tasks.
HIGHMEDIUM
schedulestring
Adherence schedule for when the task can be scheduled. Defaults to 'Work Hours' if not specified.
frequencystringObligatorio
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.
idealTimestring
Preferred scheduling time in HH:mm format (24-hour time). Motion will try to schedule the task around this time.
assigneeIdstringObligatorio
User ID to assign the task to. Use the list_users action to get valid user IDs.
startingOnstring
ISO 8601 date string for when the recurrence should start. Defaults to today if not specified.
descriptionstring
Task description. HTML input is accepted.
workspaceIdstringObligatorio
The workspace ID where the recurring task will be created
deadlineTypestringenum
Deadline type for recurring tasks.
HARDSOFT

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create TaskMOTION_CREATE_TASKAcción

Tool 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.

Parámetros de entrada

namestringObligatorio
The name of the task
labelsstring[]
List of label names to apply to the task. Labels must exist in the workspace.
statusstring
Task status name. Must match a valid status in the workspace. Use ListStatuses action to get available statuses.
dueDatestring
ISO 8601 formatted due date for the task (e.g., '2024-12-31T23:59:59Z')
durationstring
Duration in minutes (e.g., '60' for 1 hour) or 'REMINDER' for a reminder-only task
prioritystringenum
Priority levels for Motion tasks.
ASAPHIGHMEDIUMLOW
projectIdstring
Project ID to associate the task with. The project must exist in the workspace.
assigneeIdstring
User ID to assign the task to. The user must be a member of the workspace.
descriptionstring
Task description in GitHub Flavored Markdown (GFM) format
workspaceIdstringObligatorio
The workspace ID where the task will be created

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Custom FieldMOTION_DELETE_CUSTOM_FIELDAcción

Tool 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.

Parámetros de entrada

idstringObligatorio
The custom field ID to delete
workspaceIdstringObligatorio
The workspace ID where the custom field exists

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Custom Field From ProjectMOTION_DELETE_CUSTOM_FIELD_FROM_PROJECTAcción

Tool 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.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Custom Field From TaskMOTION_DELETE_CUSTOM_FIELD_FROM_TASKAcción

Tool 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.

Parámetros de entrada

taskIdstringObligatorio
The unique identifier of the task from which to delete the custom field value.
valueIdstringObligatorio
The unique identifier of the custom field value to delete from the task.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Recurring TaskMOTION_DELETE_RECURRING_TASKAcción

Tool 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.

Parámetros de entrada

idstringObligatorio
ID of the recurring task to delete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete TaskMOTION_DELETE_TASKAcción

Tool to delete a task from Motion based on task ID. Use when you need to permanently remove a task from the Motion workspace.

Parámetros de entrada

idstringObligatorio
The unique identifier of the task to delete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get My User InformationMOTION_GET_MY_USERAcción

Tool 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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ProjectMOTION_GET_PROJECTAcción

Tool 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.

Parámetros de entrada

idstringObligatorio
The ID of the project to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Task by IDMOTION_GET_TASKAcción

Tool 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.

Parámetros de entrada

idstringObligatorio
The id of the task to fetch

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List comments on taskMOTION_LIST_COMMENTSAcción

Tool 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.

Parámetros de entrada

cursorstring
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.
taskIdstringObligatorio
The ID of the task to get comments for. Required parameter to fetch all comments associated with a specific task.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Custom FieldsMOTION_LIST_CUSTOM_FIELDSAcción

Tool to retrieve all custom fields for a given Motion workspace. Use when you need to see what custom fields are available in a workspace.

Parámetros de entrada

workspace_idstringObligatorio
The workspace ID to get custom fields from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List ProjectsMOTION_LIST_PROJECTSAcción

Tool to get all projects for a workspace. Use when you need to retrieve all projects accessible to the API key, optionally filtered by workspace.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Recurring TasksMOTION_LIST_RECURRING_TASKSAcción

Tool to get all recurring tasks for a workspace. Use when you need to retrieve recurring task information from Motion.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SchedulesMOTION_LIST_SCHEDULESAcción

Tool 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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List StatusesMOTION_LIST_STATUSESAcción

Tool to get a list of statuses for a Motion workspace. Use when you need to retrieve available task statuses for a workspace.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List TasksMOTION_LIST_TASKSAcción

Tool to get all tasks for a given query with optional filtering. Use when you need to retrieve tasks from Motion, optionally filtered by assignee, project, workspace, status, label, or name.

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List usersMOTION_LIST_USERSAcción

Tool 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.

Parámetros de entrada

cursorstring
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.
teamIdstring
The ID of the team to filter users by. Filters results to return only users in the specified team.
workspaceIdstring
The ID of the workspace to get users from. Filters results to return only users in the specified workspace.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List WorkspacesMOTION_LIST_WORKSPACESAcción

Tool 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.

Parámetros de entrada

idsstring[]
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.
cursorstring
Pagination cursor to retrieve the next page of results. Use the nextCursor value from the previous response's meta object to fetch more workspaces.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Move Task to WorkspaceMOTION_MOVE_TASKAcción

Tool to move a task to a different workspace in Motion. Use when you need to relocate a task from one workspace to another.

Parámetros de entrada

idstringObligatorio
The ID of the task to move
assigneeIdstring
The user ID to assign the task to in the new workspace
workspaceIdstringObligatorio
The workspace ID to move the task to

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Unassign TaskMOTION_UNASSIGN_TASKAcción

Tool to unassign a task from its current assignee. Use when you need to remove the assignee from a task, leaving the task unassigned.

Parámetros de entrada

idstringObligatorio
The ID of the task to unassign from its current assignee

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update TaskMOTION_UPDATE_TASKAcción

Tool 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.

Parámetros de entrada

idstringObligatorio
The task ID to update
namestring
Task title
labelsstring[]
List of label names to apply to the task
statusstring
Task status name. Must match a valid status in the workspace.
dueDatestring
ISO 8601 due date for the task. Required for scheduled tasks.
durationany
Duration in minutes (>0), 'NONE' for no duration, or 'REMINDER' for reminder tasks
prioritystringenum
Priority levels for Motion tasks.
ASAPHIGHMEDIUMLOW
projectIdstring
Project ID to associate the task with
assigneeIdstring
User ID to assign the task to
descriptionstring
Task description in GitHub Flavored Markdown (GFM) format
autoScheduledobject
Auto-scheduling configuration for a task.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not