Happy Returns Get Returns

Use Happy Returns Get Returns to retrieve return records from Happy Returns by order number, email address, or both.

API Documentation link.

When to use this action

Use this action when you need to look up Happy Returns return details in a flow. You can search by:

Order number
Customer email address
Both order number and customer email address

At least one search value must be provided.

Configure the action

Add the Happy Returns Get Returns action to your flow.
Provide an Order Number, an Email Address, or both.
Use the output fields to check whether the request succeeded and whether any returns were found.

Inputs

Input	ID	Type	Required	Description
Order Number	`order_number`	Optional String	Required if Email Address is not provided	Order number to look up returns for.
Email Address	`email`	Optional String	Required if Order Number is not provided	Customer email address to look up returns for.

Outputs

Output	ID	Type	Description
Success	`success`	Boolean	Whether the Happy Returns API call was successful.
Returns Found?	`returns_found`	Boolean	Whether any returns were found for the provided search values.
Returns	`returns`	List	List of return records returned by Happy Returns.
Number of Returns	`total_items`	Number	Total number of return records found.
Message	`message`	String	Error or status message returned by the action.

Handle the result

Use success first to confirm that the API call completed successfully. Then use returns_found and total_items to decide what your flow should do next.

Condition	Meaning	Recommended next step
`success` is `true` and `returns_found` is `true`	The lookup completed and return records were found.	Use `returns` in the next step of your flow.
`success` is `true` and `returns_found` is `false`	The lookup completed, but no matching returns were found.	Continue down a no-return-found path or notify the customer.
`success` is `false`	The lookup failed.	Read `message` to understand the error and route the flow to an error-handling path.

Troubleshooting

Issue	Cause	Resolution
No returns are found	The order number or email address does not match any Happy Returns records.	Confirm the input values and try searching with both Order Number and Email Address.
The action fails before searching	Both Order Number and Email Address are empty.	Provide at least one search value.
The action returns an error message	Happy Returns returned an error or the request could not be completed.	Check the `message` output and use it to determine the next flow step.