API Documentation – Zapier & Swatle Integration
This documentation describes the Zapier ↔ Swatle integration using OAuth2.0 authentication, including 2 triggers (New Project Created & New Task Created) and 2 actions (Create Task & Update Task).
Authentication (OAuth 2.0)
The integration uses OAuth 2.0 for authentication and authorization.
Headers for API Calls:
Authorization: Bearer <ACCESS_TOKEN>
​
Content-Type: application/json
Token Refresh:
Zapier will automatically refresh the access token using the refresh token provided.
Triggers
1. New Project Created (REST Hook)
Description: Fires when a new project is added to swatle in selected workspace.
​
Endpoint (subscription):
​
POST https://app.swatle.ai/version-live/api/1.1/wf/register-webhook
​
Unsubscribe:
​
DELETE https://app.swatle.ai/version-live/api/1.1/wf/unregister-webhook
​
Output Example:
​​
{
"id": "1753943458615x26803022239340950",
​"name": "project name",
​"workspace_id": "1752673282391x77238554033179850",
​"created_at": "2025-07-31"
​}
2. New Task Created (Polling)
Description: Fires when a new task is added in the selected project.
​
Endpoint:
​
GET https://app.swatle.ai/version-live/api/1.1/wf/get_workspace_tasks
​​
​Output Example:
​​
{
"id": "1746618823306x987654321012345678",
"task_name": "Review Project Proposal",
"task_description": "Review the initial project proposal and provide feedback.",
"task_status": "In Progress",
"created_date": "2025-07-15T09:20:30Z",
"due_date": "2025-07-22T17:00:00Z"
}
Actions
1. Create Task
{​
"workspace_id”:”1234568765432345676789”,
"project_id": "1723459837263x123456789",
}
Description: Creates a new task in Swatle.
​
Endpoint:
​
POST https://app.swatle.ai/version-live/api/1.1/wf/create_task
​
Unsubscribe:​
​
Request Example:
​​
Response Example:
{
​
"task_id": "1753941281656x214601763459899550",
"status": "success"
​
}
2. Update Task
Description: Updates an existing task in Swatle.
​
Endpoint:
​
POST https://app.swatle.ai/version-live/api/1.1/wf/update_task
​
Request Example:
​​
{
​
"task_id": "1723459837263x987654321",
"status": "completed",
"task_comment": "Task closed after client approval"
​
}
Response Example:
{
​
"task_id": "1723459837263x987654321"
​
}