Amazon FBA Orders | ShipBob Developer API

ShipBob supports creating FBA Manual orders via the public API. These orders allow you to transfer inventory from a ShipBob fulfillment center to Amazon’s network, with ShipBob handling the pick, pack, and ship to Amazon.

Prerequisites

Before creating an FBA order, you’ll need:

Personal Access Token or OAuth2 credentials — used to authenticate all requests.
Channel ID — retrieved from GET /2026-01/channel. Use the channel that has _write scopes.
Location ID — the ShipBob fulfillment center ID you are transferring inventory from. Retrieve this from GET /2026-01/fulfillment_center.
FBA Shipment ID — provided by Amazon Seller Central; used as the reference_id on the order.

Key Fields

FBA Manual orders use the standard Create Order endpoint but require several fields that differ from a standard DTC order:

Field	Value	Notes
`type`	`"FBA"`	Identifies this as an FBA order type
`reference_id`	FBA Shipment ID	The FBA Shipment ID from Amazon Seller Central; must be unique within your ShipBob account
`location_id`	Fulfillment center ID	Required. Must match the ShipBob FC you are shipping inventory from
`purchase_date`	ISO 8601 datetime	The date the FBA shipment was created
`shipping_terms.carrier_type`	`"Parcel"` or `"Freight"`	Select the appropriate carrier type for your shipment
`shipping_terms.payment_term`	`"Prepaid"` or `"MerchantResponsible"`	`"Prepaid"` if ShipBob provides labels; `"MerchantResponsible"` if you upload your own
`retailer_program_data.retailer_program_type`	`"FBA-Manual"`	Required to route the order through the FBA Manual flow
`retailer_program_data.purchase_order_number`	string	The FBA purchase order number
`retailer_program_data.shipByDate`	ISO 8601 datetime	The date by which the shipment must leave the ShipBob FC
`retailer_program_data.addresses`	See below	Array of addresses; use `type: "MarkFor"` to specify the destination Amazon FC
`tags`	See below	Include the `RequiresAmazonProductLabels` tag if items need Amazon product labels

Amazon Product Labels

If the items in the order require Amazon product labels, include the following object in the tags array:

1 "tags": [
2   {
3     "name": "RequiresAmazonProductLabels",
4     "value": "..."
5   }
6 ]

The value property of this tag is not used by ShipBob. If the items do not require Amazon product labels, omit this tag entirely.

Mark For Address

The retailer_program_data.addresses array should contain the destination Amazon fulfillment center address, with type set to "MarkFor". This identifies where Amazon expects the inventory to be received:

1 "addresses": [
2   {
3     "type": "MarkFor",
4     "address1": "100 Nowhere Blvd",
5     "address2": "Suite 100",
6     "city": "City",
7     "state": "NJ",
8     "zip_code": "07093",
9     "country": "US",
10     "company_name": "Amazon Fulfillment Center"
11   }
12 ]

Finding Your Fulfillment Center ID

Call the Get Fulfillment Center endpoint to retrieve the ID of the fulfillment center you want to transfer inventory from:

$ GET https://api.shipbob.com/2026-01/fulfillment_center

Locate the fulfillment center in the response and note its id. This value is what you’ll pass as location_id on the order.

Sample Requests

FBA Order (without Amazon Product Labels)

POST https://api.shipbob.com/2026-01/order

1 {
2   "type": "FBA",
3   "reference_id": "FbaShipmentIdHere10",
4   "location_id": 10,
5   "purchase_date": "2026-02-22T14:15:22Z",
6   "shipping_method": "Free 2-day Shipping",
7   "recipient": {
8     "name": "Company test",
9     "address": {
10       "address1": "5396 North Reese Avenue",
11       "city": "Fresno",
12       "state": "CA",
13       "zip_code": "93722",
14       "country": "US"
15     },
16     "email": "email@shipbob.com",
17     "phone_number": "555-555-5555"
18   },
19   "products": [
20     {
21       "reference_id": "TestProduct1",
22       "quantity": 1
23     }
24   ],
25   "shipping_terms": {
26     "carrier_type": "Parcel",
27     "payment_term": "Prepaid"
28   },
29   "retailer_program_data": {
30     "purchase_order_number": "001",
31     "retailer_program_type": "FBA-Manual",
32     "addresses": [
33       {
34         "address1": "100 Nowhere Blvd",
35         "address2": "Suite 100",
36         "city": "City",
37         "company_name": "Company",
38         "country": "US",
39         "state": "NJ",
40         "type": "MarkFor",
41         "zip_code": "07093"
42       }
43     ],
44     "shipByDate": "2026-02-28T14:15:22Z"
45   }
46 }

FBA Order (with Amazon Product Labels)

POST https://api.shipbob.com/2026-01/order

1 {
2   "type": "FBA",
3   "reference_id": "FbaShipmentIdHere10",
4   "location_id": 10,
5   "purchase_date": "2026-02-22T14:15:22Z",
6   "shipping_method": "Free 2-day Shipping",
7   "recipient": {
8     "name": "Company test",
9     "address": {
10       "address1": "5396 North Reese Avenue",
11       "city": "Fresno",
12       "state": "CA",
13       "zip_code": "93722",
14       "country": "US"
15     },
16     "email": "email@shipbob.com",
17     "phone_number": "555-555-5555"
18   },
19   "products": [
20     {
21       "reference_id": "TestProduct1",
22       "quantity": 1
23     }
24   ],
25   "tags": [
26     {
27       "name": "RequiresAmazonProductLabels",
28       "value": "..."
29     }
30   ],
31   "shipping_terms": {
32     "carrier_type": "Parcel",
33     "payment_term": "Prepaid"
34   },
35   "retailer_program_data": {
36     "purchase_order_number": "001",
37     "retailer_program_type": "FBA-Manual",
38     "addresses": [
39       {
40         "address1": "100 Nowhere Blvd",
41         "address2": "Suite 100",
42         "city": "City",
43         "company_name": "Company",
44         "country": "US",
45         "state": "NJ",
46         "type": "MarkFor",
47         "zip_code": "07093"
48       }
49     ],
50     "shipByDate": "2026-02-28T14:15:22Z"
51   }
52 }