Set Up Your ShipMonk Integration
Plans: Premium, Enterprise Platforms: All platforms
AfterShip Returns and ShipMonk is a two-way integration designed to perform the following actions on both platforms.
Create an RMA request within ShipMonk when a return is initiated and approved through the AfterShip Returns admin
Trigger an automated action within AfterShip Returns based on the return status updates in ShipMonk
In this article, we will show you:
How it works
Get ShipMonk API Key and store ID
Integrate ShipMonk with AfterShip Returns
Configure warehouse location in return routing rules
Return workflow
The integration leverages AfterShip Returns’ Webhook feature to create returns in ShipMonk as soon as an RMA request is created and approved in AfterShip Returns.
The tracking number will be auto-synced to ShipMonk once the return label is generated or tracking information is uploaded by the shopper.

When the warehouse receives the items and the return status is updated in ShipMonk, the integration uses ShipMonk’s Webhook feature to auto-mark return requests as received in AfterShip Returns admin.
The quantity of the receiving items should be the same as in the original return request.
Request your ShipMonk API Key and Store ID by emailing support@shipmonk.com or your dedicated account manager at ShipMonk.
Go to Apps in AfterShip Returns admin
Click View more apps, and you will be redirected to the AfterShip Returns integration page.

Find ShipMonk and select it to land on the detailed integration page
Select AfterShip Returns from the dropdown and then click Install app

Select the right organization (online store) if you have multiple organizations configured in AfterShip Returns (Optional) for which you are establishing this integration
To install the ShipMonk app, you need to fill in the API Key and Store ID by emailing support@shipmonk.com or your account manager at ShipMonk to authenticate the connection

Click Install app
In the Authorization window, again click Allow & Install
Since this integration will auto-trigger a response in AfterShip Returns admin once all the items reach ShipMonk’s warehouse location, you must configure the warehouse location to ShipMonk in Return routing rules for an auto-return label generation.
Go to Return routing rules in the AfterShip Returns admin
Select a return zone for which you wish to enable this return shipping method
Add a new routing rule or edit an existing routing rule
Navigate to Ship with a return label - Auto-generate return labels under the Return shipping methods.
While setting up return shipping information for auto-return label generation, select ShipMonk from the dropdown under Return location

The RMA request will be marked as received as soon as all the products for which the return request is submitted are received by the ShipMonk warehouse
If Auto-mark as received is enabled in AfterShip Returns and ShipMonk is selected as the Warehouse location under Return routing rules, the RMA request will be marked as received as soon as all the products for which the return request is submitted are received by the ShipMonk warehouse
Auto-mark as received once delivered automation rule will be only triggered if all the products for which the return request is submitted are received by ShipMonk
1. RMA Create trigger
Create RMA in ShipMonk once RMA is approved in AfterShip Returns
2. Data flow
RMA# → AfterShip Return will create an RMA in ShipMonk and fill in the AfterShip RMA# same as the RMA# in ShipMonk
SKU → AfterShip Returns will select the responding product title and product SKU from ShipMonk to create the RMA. Return quantity will be the same as what it is on AfterShip Returns
Return reason → By default, we will select “Unknown” for the return reason field in ShipMonk and will input the return reason from AfterShip Returns in the Note field in ShipMonk
Return label tracking number → AfterShip Returns will sync the label tracking number to the ShipMonk Tracking number field
Desire Action → Since this field is required by ShipMonk, AfterShip Returns will select “Return to Inventory”, by default
When all the return items are received by ShipMonk, then the RMA will be “Marked as received” automatically in AfterShip Returns
If “Auto-mark as received once delivered” is enabled and ShipMonk is connected, the auto-receive function will be triggered when ShipMonk receives all return items instead of “delivered” status.
Overview
AfterShip Returns and ShipMonk is a two-way integration designed to perform the following actions on both platforms.
Create an RMA request within ShipMonk when a return is initiated and approved through the AfterShip Returns admin
Trigger an automated action within AfterShip Returns based on the return status updates in ShipMonk
What you’ll learn
In this article, we will show you:
How it works
Get ShipMonk API Key and store ID
Integrate ShipMonk with AfterShip Returns
Configure warehouse location in return routing rules
Return workflow
How it works
The integration leverages AfterShip Returns’ Webhook feature to create returns in ShipMonk as soon as an RMA request is created and approved in AfterShip Returns.
The tracking number will be auto-synced to ShipMonk once the return label is generated or tracking information is uploaded by the shopper.

When the warehouse receives the items and the return status is updated in ShipMonk, the integration uses ShipMonk’s Webhook feature to auto-mark return requests as received in AfterShip Returns admin.
The quantity of the receiving items should be the same as in the original return request.
Get the ShipMonk API Key and store ID
Request your ShipMonk API Key and Store ID by emailing support@shipmonk.com or your dedicated account manager at ShipMonk.
Integrate ShipMonk with AfterShip Returns
Go to Apps in AfterShip Returns admin
Click View more apps, and you will be redirected to the AfterShip Returns integration page.

Find ShipMonk and select it to land on the detailed integration page
Select AfterShip Returns from the dropdown and then click Install app

Select the right organization (online store) if you have multiple organizations configured in AfterShip Returns (Optional) for which you are establishing this integration
To install the ShipMonk app, you need to fill in the API Key and Store ID by emailing support@shipmonk.com or your account manager at ShipMonk to authenticate the connection

Click Install app
In the Authorization window, again click Allow & Install
Configure warehouse location in return routing rules
Since this integration will auto-trigger a response in AfterShip Returns admin once all the items reach ShipMonk’s warehouse location, you must configure the warehouse location to ShipMonk in Return routing rules for an auto-return label generation.
Go to Return routing rules in the AfterShip Returns admin
Select a return zone for which you wish to enable this return shipping method
Add a new routing rule or edit an existing routing rule
Navigate to Ship with a return label - Auto-generate return labels under the Return shipping methods.
While setting up return shipping information for auto-return label generation, select ShipMonk from the dropdown under Return location

When will the RMA requests be marked as received automatically?
The RMA request will be marked as received as soon as all the products for which the return request is submitted are received by the ShipMonk warehouse
If Auto-mark as received is enabled in AfterShip Returns and ShipMonk is selected as the Warehouse location under Return routing rules, the RMA request will be marked as received as soon as all the products for which the return request is submitted are received by the ShipMonk warehouse
Auto-mark as received once delivered automation rule will be only triggered if all the products for which the return request is submitted are received by ShipMonk
Return Workflow
Create RMA in ShipMonk when RMA is approved in Returns
1. RMA Create trigger
Create RMA in ShipMonk once RMA is approved in AfterShip Returns
2. Data flow
RMA# → AfterShip Return will create an RMA in ShipMonk and fill in the AfterShip RMA# same as the RMA# in ShipMonk
SKU → AfterShip Returns will select the responding product title and product SKU from ShipMonk to create the RMA. Return quantity will be the same as what it is on AfterShip Returns
Return reason → By default, we will select “Unknown” for the return reason field in ShipMonk and will input the return reason from AfterShip Returns in the Note field in ShipMonk
Return label tracking number → AfterShip Returns will sync the label tracking number to the ShipMonk Tracking number field
Desire Action → Since this field is required by ShipMonk, AfterShip Returns will select “Return to Inventory”, by default
Mark as received automatically when ShipMonk receives the return items
When all the return items are received by ShipMonk, then the RMA will be “Marked as received” automatically in AfterShip Returns
If “Auto-mark as received once delivered” is enabled and ShipMonk is connected, the auto-receive function will be triggered when ShipMonk receives all return items instead of “delivered” status.
Updated on: 27/09/2023
Thank you!