My Service Orders

Interact securely with active service orders using our comprehensive Chat API & Webhooks.

Fetch Service Order Status

Service orders require manual processing. You must periodically check strings or utilize webhooks (explained below) to track order progression (PENDING ➔ PROCESSING ➔ COMPLETED).

GET
https://api.hsmail.shop/v1/order/U35MFE9656S7
Headers:Authorization: (Not Set - Set in Topbar)

Messaging Simulator (Polling)

Once a Service Order is created, a dedicated message thread is generated. Users can communicate directly with the admin via this endpoint. Files can be attached via the /order/upload API endpoint.

Static Restriction Note: This documentation site is a static export and cannot receive webhooks directly. For this simulator, we are utilizing short-polling every 3 seconds against GET /v1/order/:id/messages. In your actual backend, you should utilize Webhooks instead to prevent rate-limiting!

Order Chat #U35MFE9656S7

Status: Unknown

Click "Connect & Fetch" to load messages.

Webhooks (The Optimal Integration)

Instead of relying on heavy polling as demonstrated above, we strongly recommend implementing a Webhook receiver on your actual backend application (e.g., Node.js, Express, PHP).

Once set up via your Account Security Page, our HS Mail servers will automatically send instantaneous JSON POST requests to your specific Webhook URL whenever an event occurs. This covers real-time chat messages from admins, order status updates, and final credential deliveries.

Generate a Test Webhook

Not ready to build your own local node server? You can generate a free, temporary webhook receiver using `webhook.site` to perfectly visualize our backend payload deliveries.

Visit webhook.site

* Copy "Your unique URL" from their site and paste it into your HS Mail dashboard webhook configurations.