Bulk Create Vendor Deposits
POST/api/vendor-deposits/bulk-create
Create multiple vendor deposits in one call — one per item, each linked to a purchase order. Shared header fields (deposit_date, due_date, external_reference, notes, proportional_apply_enabled) apply to every deposit created.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Item fields: purchase_order_id (required), currency_id, currency_rate, currency_id_tenant_snapshot, amount, and amount_in_tenant_currency are required; supplier_id, tax_amount, tax_amount_in_tenant_currency, tax_lines, payment_term_schedule_line_index, inbound_shipment_id, payment_term_schedule_snapshot, and is_ownership_transfer are optional.
Returns 201 with the created deposits.
Request
Responses
- 201
- 401
- 403
- 422
- 429
Created
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.