Developers

Automation connectors

Connect project events to Zapier, Make, and n8n, then use scoped actions to keep work moving. Each workflow has its own managed destination and can be disconnected independently.

OpenAPI document API reference

Install and activate

Zapier

Zapier integration

Create an API key with hooks:write and the read or write scopes your workflow needs.
Create a connection, select a project, and turn on a Zap.
Load a sample, select event types, and save the enabled workflow.
Trigger a real project event, confirm the action result, then deactivate or disconnect to tear it down.

Make

Make custom app

Create an API key with hooks:write and the read or write scopes your workflow needs.
Add a connection, choose an instant or polling module, then activate the scenario.
Load a sample, select event types, and save the enabled workflow.
Trigger a real project event, confirm the action result, then deactivate or disconnect to tear it down.

n8n

n8n community node

Create an API key with hooks:write and the read or write scopes your workflow needs.
Add UnityFreak credentials, configure a node, then activate the workflow.
Load a sample, select event types, and save the enabled workflow.
Trigger a real project event, confirm the action result, then deactivate or disconnect to tear it down.

Triggers

38 project event types are available. Choose only the events your workflow needs.

task.created
task.updated
task.moved
task.assigned
task.unassigned
task.completed
task.archived
task.unarchived
task.deleted
task.restored
task.comment.added
task.comment.mentioned
task.custom_field.user_added
task.due_soon
task.overdue
sprint.created
sprint.started
sprint.completed
epic.created
epic.updated
milestone.created
milestone.updated
milestone.deleted
dependency.created
approval.requested
approval.completed
approval.rejected
dependency.overridden
dependency.reinstated
sprint.reverted
sprint.reopened
sprint.updated
sprint.deleted
sla.warning
sla.breached
project.imported
task.git.commit_linked
task.git.pr_linked

Actions and scopes

Read actions need their listed read scope. Write actions also require an eligible plan and an idempotency key supplied by the provider.

Action	Scope	Endpoint	Retry
Get Task	tasks:read	GET /api/public/v1/tasks/:taskKey	Safe to repeat
List Tasks	tasks:read	GET /api/public/v1/tasks	Safe to repeat
Create Task	tasks:write	POST /api/public/v1/projects/:projectKey/tasks	Idempotency key required
Update Task	tasks:write	PATCH /api/public/v1/tasks/:taskKey	Idempotency key required
Move Task	tasks:write	PATCH /api/public/v1/tasks/:taskKey	Idempotency key required
Set Task Assignees	tasks:write	PATCH /api/public/v1/tasks/:taskKey	Idempotency key required
Delete Task	tasks:write	DELETE /api/public/v1/tasks/:taskKey	Idempotency key required
Add Comment	tasks:write	POST /api/public/v1/tasks/:taskKey/comments	Idempotency key required
Create Project	projects:write	POST /api/public/v1/projects	Idempotency key required
Update Project	projects:write	PATCH /api/public/v1/projects/:projectKey	Idempotency key required
Create Label	projects:write	POST /api/public/v1/projects/:projectKey/labels	Idempotency key required
Add Task Label	tasks:write	POST /api/public/v1/tasks/:taskKey/labels	Idempotency key required
Remove Task Label	tasks:write	DELETE /api/public/v1/tasks/:taskKey/labels/:labelId	Idempotency key required
Create Sprint	projects:write	POST /api/public/v1/projects/:projectKey/sprints	Idempotency key required
Get Sprint	projects:read	GET /api/public/v1/sprints/:sprintId	Safe to repeat
Create Epic	projects:write	POST /api/public/v1/projects/:projectKey/epics	Idempotency key required
Get Epic	projects:read	GET /api/public/v1/epics/:epicId	Safe to repeat
Update Epic	projects:write	PATCH /api/public/v1/epics/:epicId	Idempotency key required
Read Task Custom Fields	tasks:read	GET /api/public/v1/tasks/:taskKey/custom-fields	Safe to repeat
Set Task Custom Fields	tasks:write	PUT /api/public/v1/tasks/:taskKey/custom-fields	Idempotency key required
Read Epic Custom Fields	projects:read	GET /api/public/v1/epics/:epicId/custom-fields	Safe to repeat
Set Epic Custom Fields	projects:write	PUT /api/public/v1/epics/:epicId/custom-fields	Idempotency key required

16 of 22 actions change project data.

Delivery and polling

Managed event payloads are signed. Verify the exact signed string before reading the event.
Delivery is at least once. Store and deduplicate the stable delivery ID.
Retries use bounded backoff for temporary failures. A permanent callback failure needs repair or reconnection.
Polling uses bounded windows. Save the returned checkpoint only after the full window is processed; expired checkpoints require a fresh baseline.

Troubleshooting

401 or 403: reconnect a valid key with the required scope and project access.
Suspended delivery: restore callback access, project authority, or the key, then explicitly retry a dead delivery.
Duplicate event: deduplicate using the delivery ID before running side effects.
Changed destination: create or reconnect the provider subscription; old delivery history is never sent to a new callback.