Add New Work Order Appointment

Production

https://{{subdomain}}.daftra.com/api2

POST

/work_order_appointments{format}

Creates a work-order appointment (a follow-up appointment attached to a work order). The appointment fields are wrapped in a WorkOrderAppointment object; item_id (the work order id) and date are required. Optionally include a RecurringAppointment object (with recurring set to 1) to create a repeating appointment. Requires permission to add appointments/notes. Returns 202 with the new appointment's id. Requires the Work Orders plugin to be enabled.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The appointment was created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/work_order_appointments' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data '{
    "WorkOrderAppointment": {
        "item_id": 67,
        "date": "2026-07-01 10:00:00",
        "duration": "1",
        "action_id": 5,
        "body": "Schedule the on-site visit."
    }
}'

Response Example

202 - Example 1

{
    "result": "successful",
    "code": 202,
    "id": 2415
}

GET Single Work Order Appointment

Edit Work Order Appointments