SmartMatchApp

Create Task Note

Add a new note to a specific task. Notes support HTML content and can be back-dated using the date parameter.

Example Requests:

Create a note with current date:

curl "https://<your-agency>.smartmatchapp.com/api3/tasks/<task_id>/notes/" \
    -u <token>: \
    -X POST \
    -d "body=Client confirmed the meeting for next Friday."

Create a note with a specific date:

curl "https://<your-agency>.smartmatchapp.com/api3/tasks/<task_id>/notes/" \
    -u <token>: \
    -X POST \
    -d "body=Left a voicemail." \
    -d "date=2026-02-18 10:00:00"
Request Parameters:

body: Required. The content of the note. HTML is supported.

date: (Optional) The date and time of the note in YYYY-MM-DD HH:MM:SS format. Defaults to the current date and time if not provided.

Example Success Response:
{
    "id": 5
}
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 body is missing or date is in an invalid format.
Possible errors: "this field is required", "enter a valid date/time"
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"
404 Not Found

This error occurs if the task with the specified ID does not exist.
Possible errors: "object does not exist"
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"