Orders

Create a new Order.

Changed on

Orders created externally keep the given order product's values (bypassing internal promotion or product amounts).

customer.id must be an existing Customer of the store. Unless shipping_required is false (or source is pos and the customer has no shipping address), the Customer needs a saved shipping address with a country. Order creation is not available while the store is on a free trial, and stores can create a limited number of orders through the API per day.

post/orders.json

Request

  • Base URL
    https://api.jumpseller.com/v1
  • URL
    https://api.jumpseller.com/v1/orders.json
  • Auth
    • HTTP basic
    • or API key in query parameter login and API key in query parameter authtoken
    • or OAuth 2
      Authorization code: https://accounts.jumpseller.com/oauth/authorize
      Token URL: https://accounts.jumpseller.com/oauth/token scopes: write_orders

Query parameters

localestring

Language of the translatable fields, one of the store's languages (e.g. es). Defaults to the store's default language.

Request body

Example request

{
  "order": {
    "products": [
      {
        "start_time": "2026-08-26 18:30",
        "end_time": "2026-08-26 19:00"
      }
    ]
  }
}

Response

OK

Changes

    • info

      added the optional property / to the response with the status

    • info

      removed the volta enum value from the /// response property for the response status

    • breaking

      the request property / became required

    • breaking

      the request property // became required

    • breaking

      the request property / became required

    • breaking

      the request property /// became required

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the /// response's property format changed from string to no format for status

    • breaking

      the // response's property type changed from number to string for status

    • breaking

      the // response's property type changed from number to string for status

    • breaking

      the // response's property type changed from number to string for status

    • warning

      removed the request property ///

    • warning

      removed the request property ///

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      added the new Created enum value to the / response property for the response status

    • warning

      added the new Created enum value to the / response property for the response status

    • warning

      added the new billing enum value to the /// response property for the response status

    • warning

      added the new contact enum value to the /// response property for the response status

    • warning

      added the new fulfilled enum value to the / response property for the response status

    • warning

      added the new fulfilled enum value to the / response property for the response status

    • warning

      added the new in_preparation enum value to the / response property for the response status

    • warning

      added the new not_applicable enum value to the / response property for the response status

    • warning

      added the new other enum value to the /// response property for the response status

    • warning

      added the new partial enum value to the / response property for the response status

    • warning

      added the new point_pickup enum value to the / response property for the response status

    • warning

      added the new shipping enum value to the /// response property for the response status

    • warning

      added the new unfulfilled enum value to the / response property for the response status

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      for the query request parameter locale, the format was generalized from string to no format

    • info

      the request property default value false was added

    • info

      the request property default value 1 was added

    • info

      added the new Created enum value to the request property /

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed the Delivered enum value from the / response property for the response status

    • info

      removed the Failed enum value from the / response property for the response status

    • info

      removed the In Transit enum value from the / response property for the response status

    • info

      removed the Pickup Available enum value from the / response property for the response status

    • info

      removed the Requested enum value from the / response property for the response status

    • info

      removed the Unfulfilled enum value from the / response property for the response status