SmartMatchApp

Create Task

Create a new task on a board. If no board_id is provided, the task is assigned to the first available board automatically.

Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/tasks/" \
    -u <token>: \
    -X POST \
    -d "title=Follow up with client" \
    -d "board_id=1" \
    -d "status_id=2" \
    -d "priority=3" \
    -d "due_date=2026-03-15" \
    -d "user_assigned_id=5" \
    -d "user_created_id=7"
Request Parameters:

title: Required. The title of the task. Maximum 255 characters.

description: (Optional) The task description. Supports HTML.

board_id: (Optional) The ID of the board to assign the task to.

status_id: (Optional) The ID of the initial status for the task.

due_date: (Optional) The due date in YYYY-MM-DD format.

user_assigned_id: (Optional) The agency user ID to assign the task to.

user_created_id: (Optional) The agency user ID to record as the task creator, for filing a task on behalf of someone. Must be a valid agency user ID. Defaults to the API token's own user.

priority: (Optional) Priority level: 1 = Low, 2 = Medium, 3 = High.

folder_id: (Optional) The ID of the folder to place the task in.

is_template: (Optional) Set to true to create the task as a template. Default is false.

Example Success Response:
{
    "id": 42
}
Base Request:

Method: POST

Authentication: Basic Authentication. Requires a valid <token> passed.

Rate Limits:

10 requests within 10 seconds

Error Responses:
400 Bad Request

This error occurs if title is missing or any field value is invalid.
Possible errors: "this field is required", "enter a valid date"
401 Unauthorized

This error occurs when the <token> is missing, invalid, or the API access is disabled.

Possible errors: "not authenticated" or "token is disabled" or "Agency API is disabled"
405 Method Not Allowed

This error occurs if an HTTP method other than POST is used.
Possible errors: "wrong method"
429 Too Many Requests

This error occurs when the client has sent too many requests in a given amount of time, leading to rate limiting by the server.

Possible errors: "too many requests"
500 Server Error

Possible errors: "Internal server error"