--- schema_version: "1" id: 53e23762ad18923c86b084c3e037818c912390787ded837934d856764819883f title: Raise Error () collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/anypoint-code-builder/acb-component-raise-error.md canonical_url: https://docs.mulesoft.com/anypoint-code-builder/acb-component-raise-error source_site: docs.mulesoft.com content_type: documentation content_hash: 4e3f881382240ed6ef8e3daef2341cf775311c7df22ca67c873303e2ec1a216a description: MuleSoft Documentation Site latest: true --- --- product: Anypoint Code Builder version: master --- # Raise Error () > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Generates a Mule error to indicate that a failure occurred. You can customize the error’s description and type. Use this component to raise: - Core runtime errors, such as `MULE:SECURITY` and `MULE:CONNECTIVITY`. - Custom error types. You cannot raise an error from another connector or module, such as `FILE:FILE_NOT_FOUND` or `JSON:INVALID_SCHEMA`. You cannot use a connector’s existing namespace. ## Component XML This component supports the following XML structure: ```xml ``` Raise Error (``) attributes are configurable through the UI and XML.

Attribute Name	Attribute XML	Description
Raise error (default)	`doc:name`	Editable name for the component to display in the canvas.
N/A	`doc:id`	Automatically generated identifier for the component.
Type	`type`	The type of error.
Description	`description`	The error description.

## Examples ### Example: Raising an Error After an Invalid User Input The following example of a driving lessons platform checks that the user is over 16 years old. The flow raises a custom `PRECONDITIONS:INCORRECT_AGE` error when the user enters an age less than 16 years. ```xml

(1) (2) (3)

(4)

(5)

```

1	The Choice router components adds conditional processing to the flow.
2	If the age parameter sent in the request is less than 16 (`http://localhost:8081/test?age=15`), the Raise Error component raises the error type `PRECONDITIONS:INCORRECT_AGE` with the description `Minimum age of 16 required to drive`.
3	If the age parameter is greater than 16 in the request (`http://localhost:8081/test?age=17`), a Logger component returns the default message `User age above 16 years. Allowed to drive`.
4	An On-Error Continue component matches the type of the error `PRECONDITIONS:INCORRECT_AGE` and executes the Logger component inside its scope. The Logger component logs the error message `Minimum age of 16 required to drive`.
5	If no age parameter is passed in the request (`http://localhost:8081/test`) the choice component automatically raises a `MULE:EXPRESSION` error when trying to evaluate the expression `#[message.attributes.queryParams.age < 16]`. No age parameter was provided in the request, so its value is null. Then, an On-Error Continue component matches the type of the error `MULE:EXPRESSION` and executes the Logger component inside its scope. The Logger component returns the message `The parameter age is missing or invalid`.

### Example: Raising an Error After Comparing Values The following example makes a request to an API (https://unsecurebank.com/balance) and stores the returned account balance in the _balance_ variable, then compares the variable with `payload.amount` to determine if the operation is possible. The Choice router produces an `ACCOUNT:INSUFFICIENT_FUNDS` error when a transfer amount surpasses the available balance, preventing the transfer from taking place. The description dynamically provides failure details. ```xml

``` ## See Also - [Mule Errors](https://docs.mulesoft.com/mule-runtime/latest/mule-error-concept) - [Error Handler ()](https://docs.mulesoft.com/anypoint-code-builder/acb-component-error-handler)