# Creates a comment for a document Creates a new comment for the specified document. Comments can only be deleted within 15 minutes of creation. Endpoint: POST /api/v3/{invoices-type}/{id}/comments Version: 3.1.0 Security: apiKeyAuth ## Path parameters: - `invoices-type` (string, required) The type of the invoice document. receipts (payment receipts) is accepted here; receipts have no create, update, clone or /new (those operations use DocumentTypeInvoiceParam). Enum: "invoices", "invoice_receipts", "simplified_invoices", "credit_notes", "debit_notes", "receipts" - `id` (integer, required) The document ID. Example: 541674 ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `comment` (object, required) - `comment.message` (string, required) Example: "This is a test comment" ## Response 201 fields (application/json): - `comment` (object) - `comment.id` (integer) Example: 195860 - `comment.type` (string) Example: "Comment" - `comment.event` (string) Human-readable, translated label of the event (e.g. Created, Finalized, Comment), not a stable key. Do not branch on it; use type instead. Example: "Comment" - `comment.author` (string) Example: "user@invoicexpress.com" - `comment.message` (string) Example: "Test comment" - `comment.date` (string) Example: "2026-05-12T15:50:30+01:00" - `comment.can_change` (boolean) Example: true - `comment.time_to_change` (integer) Example: 15 ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"Resource not found"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Validation errors for the comment: Message can't be blank or Message is too long (maximum is 255 characters). Example: [{"error":"Message can't be blank"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)