Access

Available on Pro, Enterprise and VIP. Create a scoped key in Website Account > API. The key is shown once, can be revoked at any time, and stops working if the account drops below Pro.

Create an order

POST https://www.3dprint.farm/api/integrations/orders
Authorization: Bearer dpf_your_key
Content-Type: application/json
Idempotency-Key: order-20260718-000000000001

{
  "reference": "WEB-1042",
  "items": [{ "title": "Custom planter", "sku": "PLANTER-01", "quantity": 2 }]
}

Every create request needs a new 16 to 128 character Idempotency-Key. Reuse the same key only when retrying the same order: the original 201 result is returned with replayed: true, not a second order. Reusing it with different order data returns 409. Each key has its own custom-store order references, is limited to 60 requests per minute, and receives 429 with Retry-After: 60 when limited.

Read or amend an order

GET https://www.3dprint.farm/api/integrations/orders/WEB-1042
Authorization: Bearer dpf_your_key

PATCH https://www.3dprint.farm/api/integrations/orders/WEB-1042
Authorization: Bearer dpf_your_key
Content-Type: application/json

{ "dueAt": "2026-08-04", "note": "Customer requested a later dispatch" }

A key can read and amend only orders it created. The update endpoint accepts only dueAt and note; it cannot change production status, printer assignments or line items.

Incremental order feed

GET https://www.3dprint.farm/api/integrations/orders?updatedSince=2026-07-18T00:00:00.000Z&limit=50
Authorization: Bearer dpf_your_key

The feed returns the key's own orders in update order, with an opaque nextCursor when another page is available. Use that cursor for the next request. Page sizes range from 1 to 100. Clients should tolerate a repeated order if it changes during a multi-page sync.

Safety

The API cannot read marketplace credentials, printer access codes, customer records or other workspaces. It does not expose printer controls.

Automation webhooks

The desktop app also offers Pro-and-above local outbound webhooks for orders received, assigned, completed or failed, as well as print completion and printer faults. Configure them in Desktop Settings > Features. They are not an inbound control API and the app must be running, including in the tray, for delivery.