Order Notifications

The Neto by Maropost Order Notifications API is an optional call to an external webhook in response to order status change events occurring in the Neto e-Commerce Suite. The Notifications API response will include the webstore's Webhook Verification Key so your application can ensure the call is coming from Neto.

Turn on Order Notifications

From your Neto control panel, navigate to: Settings & Tools > All Settings & Tools > API Settings. If this is the first time setting up your webhook, regenerate a new Webhook Verify Token then tick the Enable Maropost API webhook checkbox. Finally, enter your applications Webhook Endpoint (where you want to be notified about order status changes) as the Maropost API webhook URL and click Save Changes.

Neto will now trigger an order notification whenever an order status change occurs.

Practical Uses

You can use the Notification API to notify your application of new orders or changes to an existing orders status. On receipt of a notification you can then use other API calls such as GetOrder or UpdateOrder to perform a desired action. Using the Notification API can help to reduce the number of unnecessary calls you make to the application looking for new order or order status changes.

Notifications are sent as XML via POST to your specified URL.

Webhook URL

Your applications Webhook endpoint, as set in your Neto control panel

Method

POST

Headers

NETO_NOTIFICATION	"Order"
NETOAPI_KEY	Your 'Webhook Verify Token', as set in your Neto control panel

XSD Schema

EventSchema XSD

Example Notification

Order status changed to 'Pick'.

<?xml version="1.0" encoding="utf-8"?>
<Event>
  <CurrentTime>2026-01-03 01:11:12</CurrentTime>
  <EventID>34</EventID>
  <EventType>Order</EventType>
  <Order>
    <OrderID>N10154</OrderID>
    <OrderStatus>Pick</OrderStatus>
  </Order>
</Event>

Notification Structure

Element Name	Type	Description	Example
*Event*	Contains the child elements below
EventID	integer	The unique ID of the event call. This is logged.	12
CurrentTime	datetime	The (UTC) date and time the notification was sent.	2026-01-03 01:11:12
EventType	string	The type of event.	Order
*Order*	Contains the child elements below
OrderID	orderidtype	The order ID related to the event.	N12345
OrderStatus	orderstatustype	The status that the order was changed to.	Quote New On Hold New Backorder Backorder Approved Pick Pack Pending Pickup Pending Dispatch Dispatched Cancelled Uncommitted

Valid Response

If the call to your webhook is successful, your application should respond “200 OK”. If your application makes no response or provides any other response, Neto will treat the notification as undelivered, and delivery will be optionally reattempted at a later time. Check your API Webhook Retry Schedule Task settings to confirm your webstore setup.