missing_required_param
A legacy form request found a required field missing. Endpoints already migrated to the canonical parsers report the same situation as `parameter_missing`. It is also returned for an invoice, quote, proforma, delivery note or recurring invoice line sent without `tax_rate` when neither its product has an assigned tax nor your company has a default VAT for that document type: `error.param` is `lines.N.tax_rate` and `error.line_index` is the zero-based position of that line. `POST /v1/companies/{company}/invoices` also returns it when you ask for the email sending (`options.send_automatically`) and there is no possible recipient — no client, or a client with no email, and no `options.send_to`: `error.param` is `options.send_to` and no invoice is created.
| Code | Type | HTTP | Category |
|---|---|---|---|
missing_required_param | invalid_request_error | 422 | Request |
Cause
A legacy form request found a required field missing. Endpoints already migrated to the canonical parsers report the same situation as parameter_missing. It is also returned for an invoice, quote, proforma, delivery note or recurring invoice line sent without tax_rate when neither its product has an assigned tax nor your company has a default VAT for that document type: error.param is lines.N.tax_rate and error.line_index is the zero-based position of that line. POST /v1/companies/{company}/invoices also returns it when you ask for the email sending (options.send_automatically) and there is no possible recipient — no client, or a client with no email, and no options.send_to: error.param is options.send_to and no invoice is created.
What to do
Add the missing field; when branching on error codes, treat this one as an alias of parameter_missing. For a line without VAT, send tax_rate on the line named by error.line_index or set a default tax in the company tax settings. For the email sending, send options.send_to or give the client an email.