Overview
Overview
Math Helper is a private Flows360 draft connector for simple numeric operations. It documents @activepieces/piece-math-helper version 0.0.30, whose package artefact has been execution-verified by the CDK deterministic runtime. This review candidate is not published.
Use it when a workflow step needs one of the supported operations: Addition, Subtraction, Multiplication, Division, Modulo or Generate Random Number. The arithmetic actions take First Number and Second Number inputs. Addition returns first_number + second_number, Multiplication returns first_number * second_number, Division returns first_number / second_number, Modulo returns first_number % second_number, and Subtraction returns second_number - first_number.
Generate Random Number returns a pseudo-random whole number between First Number and Second Number inclusive. It is not idempotent and must not be used for tokens, secrets or IDs.
The source piece declares no triggers, no authentication and a minimum supported Activepieces release of 0.36.1.
Technical guide
Technical guide
Use one supported Math Helper action per workflow step. Arithmetic actions require First Number and Second Number. Division requires a non-zero second number; Generate Random Number returns an inclusive pseudo-random integer and is not suitable for tokens, secrets or IDs.
Capability summary
Authentication
Authentication method: No authentication required
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| Addition | Yes | No | |
| Subtraction | Yes | No | |
| Multiplication | Yes | No | |
| Division | Yes | No | |
| Modulo | Yes | No | |
| Generate Random Number | Yes | No |
Supported actions
Addition · Read
Add the first number and the second number
addition_math · Risk: low · Retry: safe
Inputs
first_number· number · Requiredsecond_number· number · Required
Subtraction · Read
Subtract the first number from the second number
subtraction_math · Risk: low · Retry: safe
Inputs
first_number· number · Requiredsecond_number· number · Required
Multiplication · Read
Multiply first number by the second number
multiplication_math · Risk: low · Retry: safe
Inputs
first_number· number · Requiredsecond_number· number · Required
Division · Read
Divide first number by the second number
division_math · Risk: low · Retry: safe
Inputs
first_number· number · Requiredsecond_number· number · Required
Modulo · Read
Get the remainder of the first number divided by second number
modulo_math · Risk: low · Retry: safe
Inputs
first_number· number · Requiredsecond_number· number · Required
Generate Random Number · Read
Generate random number between two numbers (inclusive)
generate_random_math · Risk: low · Retry: safe
Inputs
first_number· number · Requiredsecond_number· number · Required
Setup
Setup
- Add a Math Helper step to a draft Flows360 workflow.
- No connection, API key or OAuth configuration is required.
- Choose exactly one supported action: Addition, Subtraction, Multiplication, Division, Modulo or Generate Random Number.
- Provide the required First Number and Second Number values for the selected action.
- For Division, ensure Second Number is not zero. The action validates this input before computing the result.
- For Generate Random Number, provide First Number as the lower bound and Second Number as the upper bound for the inclusive integer range.
- Keep the connector in private draft review until Flows360 explicitly approves publication.
Limitations
Limitations
- This connector is private, in draft and unpublished. Do not present it as published.
- Runtime execution has been verified only for @activepieces/piece-math-helper version 0.0.30 by the CDK deterministic runtime. This does not verify any other catalogue connector.
- The source piece exposes no triggers and only six actions: Addition, Subtraction, Multiplication, Division, Modulo and Generate Random Number.
- Each supported action requires First Number and Second Number inputs. Multi-term formula evaluation, exponentiation and list aggregation are outside this connector's documented action set.
- Subtraction returns second_number - first_number, so the operand order is reversed from the plain field names.
- Division validates that Second Number is not zero before computing.
- Modulo uses JavaScript % behaviour. A zero divisor is not validated by the action and can return NaN.
- Generate Random Number returns a pseudo-random whole number between the two bounds inclusive when Second Number is at least First Number. It is not idempotent and is not suitable for tokens, secrets or IDs.
Troubleshooting
Why does Division fail when Second Number is zero?
Division validates second_number before computing and rejects zero with the message Second number cannot be zero. Use a non-zero divisor.
Why is the Subtraction result the opposite of what I expected?
The Subtraction action returns second_number - first_number. Put the amount being subtracted in First Number and the value it is subtracted from in Second Number.
Why did Modulo return NaN?
Modulo returns first_number % second_number using JavaScript % behaviour. The action does not validate a zero divisor, so a zero Second Number can return NaN.
Why does Generate Random Number produce a different value each time?
Generate Random Number uses pseudo-random generation over the inclusive range, so it is not idempotent. Identical inputs can return different whole numbers.