The Tripleseat Open API allows you to create tasks on supported objects.
Tasks are always associated with a parent object and are accessed via nested endpoints.
Authentication
All Tasks endpoints require OAuth2 Bearer Token authentication.
Authorization: Bearer YOUR_ACCESS_TOKEN
Supported Task Endpoints
| Object | Create Task Endpoint |
|---|---|
| Accounts | /v1/accounts/{account_id}/tasks |
| Contacts | /v1/contacts/{contact_id}/tasks |
| Bookings | /v1/bookings/{booking_id}/tasks |
| Events | /v1/events/{event_id}/tasks |
| Leads | /v1/leads/{lead_id}/tasks |
Create a Task
POST /v1/{parent}/{id}/tasks
Creates a task associated with the specified parent object.
Response Status
201 Created– Task successfully created404 Not Found– Parent object not found401 Unauthorized– Invalid or missing token
Request Body Schema
{
"body": "Follow up with client regarding contract",
"assignee_id": [5],
"due_date": "2025-01-15T12:00:00Z",
"priority": 2,
"task_type_id": 3
}Required Fields
| Field | Required | Description |
|---|---|---|
body | Yes | Task description |
assignee_id | Yes | Array of user IDs assigned to the task |
Optional Fields
| Field | Description | Acceptable Values |
|---|---|---|
due_date | Task due date (ISO 8601 format) | YYYY-MM-DDTHH:MM:SSZ |
priority | Priority level | 1 = Low, 2 = Medium, 3 = High |
task_type_id | Task type identifier | Integer (valid Task Type ID) |
Important: The assignee_id field must be an array of integers.
Example – Create Task on Event
POST /v1/events/{event_id}/tasks
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
{
"body": "Confirm final guest count",
"assignee_id": [12],
"due_date": "2025-02-01T17:00:00Z",
"priority": 3
}Task Response Schema
Successful task creation returns a Task object:
| Field | Type | Description |
|---|---|---|
id | Integer | Task ID |
name | String | Task name |
body | String | Task description |
due_date | DateTime | Due date |
completed | Boolean | Completion status |
completed_at | DateTime | Completion timestamp (nullable) |
created_at | DateTime | Creation timestamp |
updated_at | DateTime | Last updated timestamp |
taskable_id | Integer | ID of parent object |
taskable_type | String | Parent object type |
Important Limitations
- Tasks must be attached to a supported parent object.
- The API currently supports creating tasks only.
- Listing, updating, or deleting tasks is not supported via the Open API.