Add New Invoice Appointment

Production

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

POST

/invoice_appointments{format}

Creates an invoice appointment (a follow-up appointment attached to an invoice). The appointment fields are wrapped in an InvoiceAppointments object; item_id (the invoice 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.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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/invoice_appointments' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "InvoiceAppointments": {
        "item_id": 137,
        "date": "2026-07-10 10:00:00",
        "end_date": "2026-07-09 09:00:00",
        "duration": "1",
        "action_id": 5,
        "body": "test",
        "status": 5,
        "staff_id": [
            1
        ],
        "recurring": true
    },
    "RecurringAppointment": {
        "unit_name": "weekly",
        "end_date": "2026-12-01"
    }
}'

Response Example

202 - Example 1

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

GET Single Invoice Appointment

Edit Invoice Appointments