Accounting Code3

Attachment7

Attachment Certification1

Auth1

CAPAs3

Change Order5

Chart Of Accounts2

Company Info2

Custom Field2

Customer6

Customer Address5

Customer Contact5

Customer Tier2

Department4

Equipment4

Gauge Code2

Grade Code2

InProcessTrackingFieldType2

Inventory6

Inventory Event2

Inventory Event Details3

Inventory Lot3

Inventory Transactions1

Invoice6

Invoice Deposit Adjustment Line Item2

Invoice Deposit Line Item2

Invoice Discount Line Item1

Invoice Fee Line Item4

Invoice Line Item2

Invoice Note1

Invoice Part Line Item4

Invoice Refund Line Item4

Invoice Shipping Charge Line Item1

Invoice Tax Line Item2

Item12

Item Category2

Item Class2

Item Custom Fields2

Item Customer4

Item Material Vendor3

Item PriceBreaks4

Item Routing26

Item Tag5

Item Vendor3

Job9

Job Custom Fields2

Job Full Routing18

Job Item To Make3

Job Item To Make Operation8

Job Message2

Job Operation1

Job Part Line Item Full Routing1

Job Tracking Timers3

Location3

Material4

Material Code2

Material Vendor6

NCRs3

Nesting2

Note3

Operation4

Payment Term3

Purchase Order8

Purchase Order Custom Fields2

Purchase Order Discount Line Item1

Purchase Order Fee Line Item7

Purchase Order Line Item3

Purchase Order Outside Processing Line Item7

Purchase Order Part Line Item7

Purchase Order Tax Line Item2

Purchase Order Vendor Credit Line Item4

Quote11

Quote Custom Fields2

Quote Discount Line Item3

Quote Fee Line Item5

Quote Part Line Item7

Quote Part Line Item Custom Fields2

Quote Part Line Item Full Routing19

Quote Tax Line Item5

Receiving Receipt5

Receiving Receipt Line Item5

Refund Reason Code2

Reporting9

Sales Order8

Sales Order Blanket Line Item4

Sales Order Custom Fields2

Sales Order Discount Line Item3

Sales Order Fee Line Item6

Sales Order Line Item2

Sales Order Part Line Item8

Sales Order Part Line Item Custom Fields2

Sales Order Part Line Item Full Routing19

Sales Order Refund Line Item4

Sales Order Shipping Charge Line Item1

Sales Order Tax Line Item5

ScrapReport1

Shape Code2

Shipment Custom Fields1

Shipment Line Items (V3)1

Shipments5

Shipping Method2

Tag5

Task5

Tax Rate4

Time Clock Timers3

Timer4

Tool8

Tool Calibration5

User2

User Status2

Vendor5

Vendor Address5

Vendor Contact5

Work Order3

WorkCenter4

Sales Order

Create a new draft sales order

post/api/sales-orders

Request body

customerIdstring required

The id of the customer to be created

orderedDatestring date-time nullable

The ordered date of the sales order. For supplied values, only the calendar date is used, exactly as written; any time or UTC offset is ignored. If not supplied, defaults to the current UTC timestamp.

customerPoNumberstring nullable

Optional customer supplied purchase order number

externalReferencesobject nullable

Arbitrary key-value-pair like data that can be used to later on search for the Sales Order

externalQuoteUrlstring nullable

A reference URL that points to an external quote entity.

dueDatestring date-time nullable

The due date of the sales order. This indicates the expected date of completion. Only the calendar date is used, exactly as written; any time or UTC offset is ignored.

paymentTermsIdstring nullable

Payment terms key identifier. Please reference /api/payment-terms endpoint.

salesPersonIdstring nullable

Sales Person identifier. Please reference /api/users endpoint. If not provided, the salesperson defined on the customer will be used.

publicNotestring nullable

Note to customer. This will appear on PDFs.

priority'low' | 'moderate' | 'high'

Priority of the sales order

companyIdstring nullable

Company identifier. Please reference /api/companies endpoint. If not provided, the primary company will be used (if available).

productionDueDatestring date-time nullable

The date that the production of items on the sales order needs to be completed by. Only the calendar date is used, exactly as written; any time or UTC offset is ignored.

shippingMethodIdstring nullable

Shipping method identifier. Please reference /api/shipping-methods endpoint.

dropshipboolean

Marks the order as dropshipped: fulfilled by shipping directly to the end customer. Defaults to false if omitted.

dropshipCustomerPoNumberstring nullable

The end customer's purchase order number for a dropshipped order.

Response

Sales order created

idstring required

The id of the created record

Changes

Changed in 1 of the 23 revisions of this API.8

Aug 28, 2026eab32f188c848See the full diff
- ○
  added the new optional request property (media type: application/json-patch+json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: text/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/*+json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/json-patch+json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: text/json)
  new-optional-request-property
- ○
  added the new optional request property (media type: application/*+json)
  new-optional-request-property

Full history