Create Task
CUSTOM-ENDPOINT
POST https://api.speakap.io/networks/:eid/tasks/
CUSTOM-REQUEST
- URI: /networks/{networkEID}/tasks/
- Method: POST
- Content-Type: application/json
- Authentication: OAuth 2.0
Parameters
| Name | Type | Description |
|---|
| networkEID | EID | Network EID |
Request Body
Supply a complete task resource in the request body.
| Name | Type | Description |
|---|
| title | string | Title of the task. Required field. |
| messageType | string | Must be task. Required field. |
| taskType | string | Type of the task. One of: associated, individual, shared, split. Required field. |
| recipients | array | List of recipient objects. Required field. |
| recipients[i].EID | EID | EID of the recipient (user, group, or network) |
| recipients[i].type | string | user, group, or network |
| dueDate | datetime | The due date for the task. Optional field. |
| attachments | array | List of attachment objects. Optional field. |
Task Types
| Value | Description |
|---|
| associated | Task associated with another entity |
| individual | Individual task assigned to specific users |
| shared | Shared task that can be completed by any assignee |
| split | Split task where each assignee completes their own portion |
Example (task)
{
"title": "Pick up delivery",
"messageType": "task",
"taskType": "individual",
"recipients": [
{
"EID": "{{UserEID}}",
"type": "user"
}
],
"dueDate": "2025-01-20T17:00:00.000+00:00",
"attachments": []
}
Response