missing_request_parameter

Error cause indicating required request parameters were not provided.


What this means

The Commerce API endpoint you called requires one or more parameters that were not included in your request. Each endpoint has a defined set of required parameters that must be present for the operation to proceed—when any of these mandatory fields are absent, you'll receive this error cause. For example, paying for an order without providing the order_id parameter, or connecting a financial account without specifying the required account details.

The error detail field will identify exactly which parameter is missing, allowing you to add it to your request before retrying. This differs from invalid_request_parameter where the parameter is provided but its value doesn't meet validation requirements. Missing parameter errors are permanent failures that always require modifying your request to include the required fields—the Commerce API cannot proceed with incomplete information.


Example error response

{
  "error": {
    "type": "invalid_request_parameter",
    "cause": "missing_request_parameter",
    "code": "1672",
    "message": "required parameter missing",
    "detail": "The `order_id` parameter is required but was not provided.",
    "fix_code": "change_request_parameters",
    "url": "https://commerce.zebo.dev/e/1672"
  }
}

Was this page helpful?