Bulk invoice import batch completed

webhook

invoiceImportFinished

Fired when a bulk invoice import batch (submitted to POST /accounts/{account}/invoices/imports) finishes processing. The payload carries the batch id, final status and summary counts; fetch the full per-file results from status_url (GET /accounts/{account}/invoices/imports/{id}).

Payload

Notification that a bulk invoice import batch has reached a terminal state. Fetch the full per-file results from the status_url.

code

string

required

Defaults to invoice_import.finished

Code that describes the event.

triggered_at

integer

required

Unix timestamp indicating when the event was triggered.

data

object

required

Batch identity, final status and summary counts. The full per-file results stay behind status_url to keep the body bounded for large batches.

Headers

X-B2Brouter-Signature

string

required

Contains a signature to verify the authenticity and integrity of the request.
The signature is generated using the HMAC-SHA256 algorithm with a payload composed of the timestamp and the JSON data.
Format: t={timestamp},s={signature}.

X-B2Brouter-Delivery-Id

string

required

Identifies the delivery. Every attempt of the same delivery carries the same value, so use it to discard
a delivery you have already processed. Treat it as an opaque string. It is not covered by
X-B2Brouter-Signature, so do not rely on it to detect replayed requests.

X-B2Brouter-Delivery-Attempt

string

required

Attempt number of this delivery: 1 for the first attempt, then 2, 3, ... for each automatic retry.
A delivery resent manually from the B2Brouter delivery log repeats the number of its last attempt, which
is 0 if it was never attempted automatically.

Responses

200

Return a 200 status to indicate that the data was received successfully

404

The webhook URL could not be reached. Ensure the URL is correct and reachable.