Orders

Submit Order

Submits an order for fulfillment or reschedules its submit date.

Submitting an order makes it eligible for the operations team to begin fulfillment. Once submitted, the order enters the fulfillment pipeline and edit restrictions apply:

  • During picking, order items cannot be changed.
  • Once packed, no fields on the order can be changed.

This endpoint serves two purposes:

  • Submit immediately — pass a submit_at timestamp in the past (or now) to release the order into the fulfillment queue right away.
  • Reschedule the submit date — even though submit_at can be set when creating an order, this is the simplest way to change it after the fact.

When submit_at is in the future, inventory is reserved immediately and the order is released into the fulfillment queue at the scheduled time.

post/v1/integrations/submit-order

Request

  • Base URL: https://api.shipmonk.com
  • URL: https://api.shipmonk.com/v1/integrations/submit-order
  • Auth: API key in header Api-Key

Request body

order_keystring required

Unique identifier of the order in the external (caller's) system, as originally supplied when the order was created.

store_idinteger required

Identifier of the store this return belongs to.

submit_atstring date-time required

ISO 8601 timestamp at which the order should be released into the fulfillment queue; submitting in the past releases it immediately.

Example request

{
  "order_key": "327b5abd-017a-4504-a50d-54f1cea80269",
  "store_id": 123456,
  "submit_at": "2025-07-24 14:53:00"
}

Response

Success

statusinteger required

Changes

No recorded changes to this operation across all 16 revisions of this API.