MeisterTask
Create, list, and update tasks in MeisterTask.
On this page
Connect
Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.
- In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
- For every project in a workspace: Workspace settings, Integrations.
- Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.
Call it from a workflow
Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.
// .workflow.js (native ctx)
export async function run(ctx) {
const res = await ctx.integrations.invoke("meistertask", "create_task", {
"project": "<project>",
"section": "<section>",
"name": "<task name>"
});
if (!res.success) throw new Error(res.error);
ctx.log.info("MeisterTask answered", { output: res.output });
}// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";
export default defineWorkflow({
id: "meistertask-create-task",
name: "MeisterTask: Create Task",
description: "Calls MeisterTask when a row is created.",
trigger: { type: "entity_event", entity: "tickets", event: "created" },
async run(ctx, event) {
const res = await ctx.integrations.call("meistertask", {
"action": "create_task",
"project": "<project>",
"section": "<section>",
"name": "<task name>"
}) as { success: boolean; error?: string };
if (!res.success) throw new Error(res.error);
},
});curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/meistertask/create_task" \
-H "Authorization: Bearer $APP_KEY" \
-H "content-type: application/json" \
-d '{"props":{"project":"<project>","section":"<section>","name":"<task name>"}}'Actions
create_taskin catalog
Create Task. Creates a new task
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
sectionrequired | id (picked from your account) | Section |
namerequired | text | Task Name |
notesoptional | long text | Notes |
assigned_tooptional | id (picked from your account) | Person |
due_dateoptional | date-time (ISO) | Due Date |
update_taskin catalog
Update Task. Updates an existing task
| Input | Type | Description |
|---|---|---|
Projectrequired | id (picked from your account) | Project |
task_idrequired | id (picked from your account) | Task |
nameoptional | text | Task Name |
notesoptional | long text | Notes |
statusoptional | one of "1" | "2" | "18" | Status |
assigned_tooptional | id (picked from your account) | Person |
due_dateoptional | date-time (ISO) | Due Date |
create_attachment
Create Attachment. Creates a new attachment
| Input | Type | Description |
|---|---|---|
task_idrequired | id (picked from your account) | Task |
file_urlrequired | file | URL of the file to attach |
nameoptional | text | Attachment Name |
create_label
Create Label. Creates a new label
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
namerequired | text | Label Name |
coloroptional | text | Hex color code (e.g., #FF0000) |
create_task_label
Create Task Label. Creates a new task label
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
task_idrequired | id (picked from your account) | Task |
labelrequired | id (picked from your account) | Label |
custom_api_call
Custom API Call. Make a custom API call to a specific endpoint
| Input | Type | Description |
|---|---|---|
urlrequired | object (depends on other props) | url |
methodrequired | one of "GET" | "POST" | "PATCH" | "PUT" | "DELETE" | "HEAD" | Method |
headersrequired | object | Authorization headers are injected automatically from your connection. |
queryParamsrequired | object | Query Parameters |
body_typeoptional | one of "none" | "json" | "form_data" | "raw" | Body Type |
bodyoptional | object (depends on other props) | Body |
response_is_binaryoptional | boolean | Enable for files like PDFs, images, etc. |
failsafeoptional | boolean | No Error on Failure |
timeoutoptional | number | Timeout (in seconds) |
followRedirectsoptional | boolean | Follow redirects |
find_attachment
Find Attachment. Finds an attachment by searching
| Input | Type | Description |
|---|---|---|
task_idrequired | id (picked from your account) | Task |
nameoptional | text | Attachment Name |
find_label
Find Label. Finds a label by searching
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
namerequired | text | Label Name |
find_or_create_attachment
Find or Create Attachment. Finds an attachment by searching, or creates one if it doesn't exist
| Input | Type | Description |
|---|---|---|
task_idrequired | id (picked from your account) | Task |
namerequired | text | Attachment Name |
file_urlrequired | file | URL of the file to attach (used if creating) |
find_or_create_label
Find or Create Label. Finds a label by searching, or creates one if it doesn't exist
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
namerequired | text | Label Name |
coloroptional | text | Hex color code (e.g., #FF0000) - used if creating |
find_or_create_task
Find or Create Task. Finds a task by searching, or creates one if it doesn't exist
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
sectionrequired | id (picked from your account) | Section |
namerequired | text | Task Name |
notesoptional | long text | Notes for the task (used if creating) |
assigned_tooptional | id (picked from your account) | Person |
due_dateoptional | date-time (ISO) | Due date for the task (used if creating) |
find_person
Find Person. Finds a person based on person_id
| Input | Type | Description |
|---|---|---|
person_idrequired | number | Person ID |
find_task
Find Task. Finds a task by searching
| Input | Type | Description |
|---|---|---|
projectrequired | id (picked from your account) | Project |
sectionrequired | id (picked from your account) | Section |
nameoptional | text | Task Name |
Details
- Id
meistertask- Category
- Productivity
- Tags
- tasks, kanban, project-management
- Package
@activepieces/piece-meistertask@0.1.4- Tier
- Community