Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
## 1.3.0

- New triggers (instant, Taskade Pro plan or higher): New Comment, Task Assigned, New Project, Project Assigned, Member Joined Project.
- New task actions: Complete Task, Update Task, Delete Task, Move Task, Set Task Due Date, Assign Task, Set Task Note, Set Task Custom Field.
- New project actions: Create Project, Create Project From Template, Complete Project, Copy Project, Get Project Share Link.
- New AI agent actions: Run AI Agent, Create AI Agent, Generate AI Agent, Update AI Agent, Add Knowledge to AI Agent, Enable Public Agent Access.
- New actions: Run Automation (starts a Taskade automation that begins with a webhook trigger), Custom API Call.
- New searches: Find Task, Find Project, Find AI Agent, Get Project Content.
- Update: Run AI Agent picks the folder and the agent from dropdowns.
- Update: Create Task has a clearer description. Task Due and Create Task keep their inputs and outputs.

## 1.0.8

- Fix: connections no longer expire about 1 hour after connecting.
68 changes: 50 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,21 +11,50 @@ Building a Taskade integration for another platform (n8n, Activepieces, Make, Pi

| Platform | Status |
|---|---|
| Zapier | Live: [Taskade on Zapier](https://zapier.com/apps/taskade/integrations). Deploys are manual, so the live app version can lag this source. |
| n8n | Source in [`packages/n8n-nodes-taskade`](packages/n8n-nodes-taskade) (package `n8n-nodes-taskade` 0.2.0). Not yet published to npm. |
| Activepieces, Make, Pipedream | Planned. No code in this repo yet. |
| Zapier | Live: [Taskade on Zapier](https://zapier.com/apps/taskade/integrations). The public version has 1 trigger (Task Due) and 1 action (Create Task). This source holds the full set below. Deploys are manual, so the live app version can lag this source. |
| Activepieces | Live: [Taskade on Activepieces](https://www.activepieces.com/pieces/taskade) (`@activepieces/piece-taskade`). Activepieces maintains the piece in [its own repo](https://github.com/activepieces/activepieces). |
| Pipedream | Live: [Taskade on Pipedream](https://pipedream.com/apps/taskade). Pipedream maintains the components in [its own repo](https://github.com/PipedreamHQ/pipedream). |
| n8n | Source in [`packages/n8n-nodes-taskade`](packages/n8n-nodes-taskade). Not yet published to npm. |
| Make | In review: the official Make app is in [#34](https://github.com/taskade/integrations/pull/34). Not yet on Make. |

## Zapier app capabilities

| Type | Keys | Notes |
|---|---|---|
| Trigger (instant) | `task_due` | Fires when a task is due. Uses Taskade-internal webhook routes. |
| Trigger (instant) | `new_comment`, `task_assigned`, `new_project`, `project_assigned`, `project_joined` | Use the public webhook-subscription API (`POST /api/v2/subscribeWebhook`) |
| Action (tasks) | `create_task`, `complete_task`, `update_task`, `delete_task`, `move_task`, `set_task_date`, `assign_task`, `set_task_note`, `set_custom_field` | `create_task` splits content over 2000 characters into sibling tasks |
| Action (projects) | `create_project`, `create_project_from_template`, `complete_project`, `copy_project`, `enable_share_link` | |
| Action (AI agents) | `run_agent`, `create_agent`, `generate_agent`, `update_agent`, `add_agent_knowledge`, `publish_agent` | `run_agent` prompts an agent and returns its response |
| Action (other) | `trigger_automation`, `custom_api_call` | `custom_api_call` sends an authenticated request to any Taskade API endpoint |
| Search | `find_task`, `find_project` | |
All triggers are instant (webhooks). The 5 triggers on the public webhook-subscription API need a Taskade Pro plan or higher. Actions and searches do not need Pro. Run AI Agent and Generate AI Agent use AI credits, and Run Automation needs an automation with a webhook trigger, which also needs Pro.

| Type | Name | Key | Notes |
|---|---|---|---|
| Trigger | Task Due | `task_due` | Fires when a task is due. Uses Taskade-internal webhook routes. |
| Trigger | New Comment | `new_comment` | Public webhook-subscription API (`POST /api/v2/subscribeWebhook`) |
| Trigger | Task Assigned | `task_assigned` | Public webhook-subscription API |
| Trigger | New Project | `new_project` | Public webhook-subscription API |
| Trigger | Project Assigned | `project_assigned` | Public webhook-subscription API |
| Trigger | Member Joined Project | `project_joined` | Public webhook-subscription API |
| Action | Create Task | `create_task` | Splits content over 2000 characters into sibling tasks |
| Action | Complete Task | `complete_task` | Can also reopen a task |
| Action | Update Task | `update_task` | |
| Action | Delete Task | `delete_task` | |
| Action | Move Task | `move_task` | |
| Action | Set Task Due Date | `set_task_date` | Can also clear the date |
| Action | Assign Task | `assign_task` | |
| Action | Set Task Note | `set_task_note` | |
| Action | Set Task Custom Field | `set_custom_field` | |
| Action | Create Project | `create_project` | From Markdown text |
| Action | Create Project From Template | `create_project_from_template` | |
| Action | Complete Project | `complete_project` | Can also restore a project |
| Action | Copy Project | `copy_project` | |
| Action | Get Project Share Link | `enable_share_link` | |
| Action | Run AI Agent | `run_agent` | Sends a prompt and returns the reply. Uses AI credits. |
| Action | Create AI Agent | `create_agent` | From a persona template |
| Action | Generate AI Agent | `generate_agent` | From a plain-language description |
| Action | Update AI Agent | `update_agent` | |
| Action | Add Knowledge to AI Agent | `add_agent_knowledge` | A project or a media file |
| Action | Enable Public Agent Access | `publish_agent` | |
| Action | Run Automation | `trigger_automation` | Starts a Taskade automation that begins with a webhook trigger |
| Action | Custom API Call | `custom_api_call` | Sends an authenticated request to any Taskade API endpoint |
| Search | Find Task | `find_task` | |
| Search | Find Project | `find_project` | |
| Search | Find AI Agent | `find_agent` | |
| Search | Get Project Content | `get_project_content` | Returns the project as Markdown |

Hidden dropdown helpers (not user-facing): `get_all_spaces`, `get_all_projects`, `get_all_blocks`, `get_all_assignable_members`, `get_all_tasks`, `get_all_project_templates`, `get_all_agents`, `get_all_fields`.

Expand All @@ -48,8 +77,11 @@ The test suite validates the full app definition with `zapier-platform-schema`'s

### Release

1. Bump `version` in `package.json`
2. `yarn build && zapier build && zapier push`
1. Bump `version` in `package.json` to a number that `zapier versions` does not list yet
2. Add the release notes to `CHANGELOG.md`
3. `yarn build && zapier push`
4. Test each new trigger, action and search in a Zap, then `zapier promote <version>`
5. `zapier migrate <old version> <new version> <percent>` moves existing users to the new version. Start with a small percent and watch `zapier logs`

Deploying to the live Zapier app is a deliberate, manual step — never automatic on merge.

Expand All @@ -63,13 +95,13 @@ zapier logs --type=http --detailed

## Roadmap

- Platform-agnostic operation manifest + per-platform codegen — the existing [n8n node](packages/n8n-nodes-taskade) and future targets (Activepieces, Make, Pipedream) rendered from one source
- Platform-agnostic operation manifest + per-platform codegen: the existing [n8n node](packages/n8n-nodes-taskade) and the Make app rendered from one source
- Move `task_due` to the public webhook-subscription API

See the [Zapier Integration Guide](https://help.taskade.com/en/articles/8958540-zapier-integration) for end-user docs.

## Related repos

- [Taskade Docs](https://github.com/taskade/docs) — source for [docs.taskade.com](https://docs.taskade.com)
- [Taskade MCP](https://github.com/taskade/mcp) — official MCP server ([`@taskade/mcp-server`](https://www.npmjs.com/package/@taskade/mcp-server) on npm)
- [Taskade](https://github.com/taskade/taskade) — platform home, including the Genesis AI app builder
- [Taskade Docs](https://github.com/taskade/docs): source for [docs.taskade.com](https://docs.taskade.com)
- [Taskade MCP](https://github.com/taskade/mcp): official MCP server ([`@taskade/mcp-server`](https://www.npmjs.com/package/@taskade/mcp-server) on npm)
- [Taskade](https://github.com/taskade/taskade): platform home, including the Taskade Genesis AI app builder
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "taskade",
"version": "1.2.0",
"version": "1.3.0",
"description": "Taskade is a collaboration platform for remote teams to organize and manage projects.",
"main": "index.js",
"scripts": {
Expand Down
2 changes: 1 addition & 1 deletion src/creates/createAgent.ts
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ export default {
default: 'Tasker',
required: true,
helpText:
'The agent template to start from. Any valid Taskade persona works — this list shows common ones.',
'The agent template to start from. This list shows common personas. You can also enter another valid Taskade persona.',
},
],
perform,
Expand Down
14 changes: 4 additions & 10 deletions src/creates/createProject.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ const perform = async (z: ZObject, bundle: Bundle) => {
path: '/projects',
body: {
folderId: bundle.inputData.space_id,
contentType: (bundle.inputData.content_type as string) ?? 'text/markdown',
// The endpoint accepts only Markdown. Plain text is valid Markdown.
contentType: 'text/markdown',
content: bundle.inputData.content as string,
},
});
Expand All @@ -35,15 +36,8 @@ export default {
label: 'Content',
type: 'text',
required: true,
helpText: 'Markdown content for the project, e.g. a title line followed by tasks.',
},
{
key: 'content_type',
label: 'Format',
type: 'string',
choices: { 'text/markdown': 'Markdown', 'text/plain': 'Plain text' },
default: 'text/markdown',
required: false,
helpText:
'The project text in Markdown, for example a title line followed by a list of tasks.',
},
],
perform,
Expand Down
2 changes: 1 addition & 1 deletion src/creates/createProjectFromTemplate.ts
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ export default {
key: 'create_project_from_template',
noun: 'Project',
display: {
label: 'Create Project from Template',
label: 'Create Project From Template',
description: 'Creates a new project from an existing template in a folder.',
hidden: false,
},
Expand Down
4 changes: 2 additions & 2 deletions src/creates/createTask.ts
Original file line number Diff line number Diff line change
Expand Up @@ -235,7 +235,7 @@ export default {
noun: 'Task',
display: {
label: 'Create Task',
description: 'Creates a Task in Taskade',
description: 'Creates a task in a Taskade project.',
hidden: false,
},
operation: {
Expand Down Expand Up @@ -296,7 +296,7 @@ export default {
},
{
key: 'member_id',
label: 'Assign to',
label: 'Assign To',
type: 'string',
dynamic: 'get_all_assignable_members.id.displayName',
required: false,
Expand Down
33 changes: 25 additions & 8 deletions src/creates/customApiCall.ts
Original file line number Diff line number Diff line change
@@ -1,23 +1,39 @@
import { Bundle, ZObject } from 'zapier-platform-core';

const TASKADE_ORIGIN = 'https://www.taskade.com';

const perform = async (z: ZObject, bundle: Bundle) => {
const raw = bundle.inputData.url as string;
const url = raw.startsWith('http')
? raw
: `https://www.taskade.com${raw.startsWith('/') ? '' : '/'}${raw}`;
const raw = String(bundle.inputData.url ?? '').trim();
// The request carries the user's Taskade token, so it may go only to Taskade.
// A relative path resolves against the Taskade host.
let url: URL;
try {
url = new URL(raw, TASKADE_ORIGIN);
} catch {
throw new z.errors.Error(`"${raw}" is not a valid URL or path.`, 'invalid_input', 400);
}
if (url.origin !== TASKADE_ORIGIN) {
throw new z.errors.Error(
`The URL must be on ${TASKADE_ORIGIN}. Use a path such as /api/v2/listSpaces.`,
'invalid_input',
400,
);
}

const method =
(bundle.inputData.http_method as 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH') || 'GET';
// The API rejects an empty body when the content type is JSON.
const hasBody = method === 'POST' || method === 'PUT' || method === 'PATCH';

const response = await z.request({
url,
url: url.toString(),
method,
headers: {
Accept: 'application/json',
'content-type': 'application/json',
authorization: `Bearer ${bundle.authData.access_token}`,
},
body: bundle.inputData.body ? (bundle.inputData.body as string) : undefined,
body: bundle.inputData.body ? (bundle.inputData.body as string) : hasBody ? '{}' : undefined,
// Don't auto-throw on 4xx/5xx: this escape hatch must surface the real
// status + error body so power users can inspect failed calls.
skipThrowForStatus: true,
Expand All @@ -32,7 +48,7 @@ export default {
display: {
label: 'Custom API Call',
description:
'Make an authenticated request to any Taskade API endpoint. Advanced — see developer.taskade.com.',
'Makes an authenticated request to any Taskade API endpoint. For advanced users.',
hidden: false,
},
operation: {
Expand All @@ -50,7 +66,8 @@ export default {
label: 'URL or Path',
type: 'string',
required: true,
helpText: 'A full URL, or a path such as `/api/v1/me/projects`.',
helpText:
'A path such as `/api/v2/listSpaces`, or a full `https://www.taskade.com` URL. Version 2 paths need the Method POST. See the [API docs](https://www.taskade.com/api/documentation/v2).',
},
{
key: 'body',
Expand Down
24 changes: 14 additions & 10 deletions src/creates/runAgent.ts
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
import { Bundle, ZObject } from 'zapier-platform-core';

import { ApiResponse, parseOk, request } from '../client';
import { spaceField } from '../fields';

const perform = async (z: ZObject, bundle: Bundle) => {
const response = await request(z, bundle, {
Expand All @@ -24,35 +25,38 @@ export default {
noun: 'Agent Response',
display: {
label: 'Run AI Agent',
description: 'Sends a prompt to a Taskade AI agent and returns its response.',
description:
'Sends a prompt to a Taskade AI agent and returns its reply. Each run uses AI credits from your Taskade plan.',
hidden: false,
},
operation: {
inputFields: [
{
key: 'space_id',
label: 'Workspace ID',
type: 'string',
required: true,
helpText: 'The ID of the workspace the agent belongs to.',
...spaceField(true),
label: 'Folder',
altersDynamicFields: true,
helpText: 'The workspace or folder that holds the agent.',
},
{
key: 'agent_id',
label: 'Agent ID',
label: 'Agent',
type: 'string',
dynamic: 'get_all_agents.id.title',
search: 'find_agent.id',
required: true,
helpText: 'The ID of the agent to prompt.',
list: false,
altersDynamicFields: false,
},
{
key: 'prompt',
label: 'Prompt',
type: 'text',
required: true,
helpText: 'The message to send to the agent.',
helpText: 'The message to send to the agent, for example "Summarize this support email".',
},
],
perform,
sample: { summary: 'Here is the agent response.' },
outputFields: [{ key: 'summary', label: 'Response' }],
outputFields: [{ key: 'summary', label: 'Agent Reply' }],
},
};
2 changes: 1 addition & 1 deletion src/creates/setTaskNote.ts
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ export default {
label: 'Note',
type: 'string',
required: true,
helpText: 'Note content — single line, no line breaks.',
helpText: 'The note text, on a single line with no line breaks.',
},
{
key: 'note_type',
Expand Down
6 changes: 3 additions & 3 deletions src/creates/triggerAutomation.ts
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ const perform = async (z: ZObject, bundle: Bundle) => {

if (response.status >= 400) {
throw new z.errors.Error(
`Automation webhook returned ${response.status} — check the webhook URL is current.`,
`Automation webhook returned ${response.status}. Make sure that the webhook URL is current and the automation is on.`,
'invalid_input',
response.status,
);
Expand All @@ -38,9 +38,9 @@ export default {
key: 'trigger_automation',
noun: 'Automation Run',
display: {
label: 'Trigger Taskade Automation',
label: 'Run Automation',
description:
'Starts a Taskade automation that uses a Webhook trigger, passing an optional JSON payload.',
'Starts a Taskade automation that begins with a webhook trigger, and sends it optional JSON data. Webhook triggers require a Taskade Pro plan or higher.',
hidden: false,
},
operation: {
Expand Down
4 changes: 4 additions & 0 deletions src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,10 @@ import SetTaskNote from './creates/setTaskNote';
import TriggerAutomation from './creates/triggerAutomation';
import UpdateAgent from './creates/updateAgent';
import UpdateTask from './creates/updateTask';
import FindAgent from './searches/findAgent';
import FindProject from './searches/findProject';
import FindTask from './searches/findTask';
import GetProjectContent from './searches/getProjectContent';
import GetAllAgents from './triggers/getAllAgents';
import GetAllAssignableMembers from './triggers/getAllAssignableMembers';
import GetAllBlocks from './triggers/getAllBlocks';
Expand Down Expand Up @@ -102,5 +104,7 @@ export default {
searches: {
[FindTask.key]: FindTask,
[FindProject.key]: FindProject,
[GetProjectContent.key]: GetProjectContent,
[FindAgent.key]: FindAgent,
},
};
Loading
Loading