Add attachment

post

https://api-staging.b2brouter.net/invoices/{id}/add_attachment

Adds an attachment to an existing invoice. Do not confuse with add_attachments method (note plural)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integer

required

An internal identifier that is unique to each Invoice within B2Brouter.

Query Params

filename

string

required

Name of the attachment.

use_as_pdf_view

boolean

Boolean to indicate that the uploaded PDF attachment should be used as the visual component when generating a hybrid PDF (such as a ZUGFeRD document) or any legal PDF representation. When set to true, this attachment will be considered the legal PDF to display or embed, instead of regenerating one from the invoice data. It can be used both for PDF deliveries and for embedding XML (e.g., ZUGFeRD) into the provided PDF.

NOTICE: If the invoice is modified after this PDF has been uploaded, the attachment will still be used as-is, unless explicitly replaced. B2Brouter treats it as the legal representation provided by the account.

Body Params

The attachment to add to the invoice

Headers

X-B2B-API-Version

string

Defaults to 2026-04-20

Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration B2Brouter UI Application -> Developers -> API Keys -> API Version

Responses

204

Attachment successfully added

403

Forbidden