Body
Required
-
Address validation endpoint
-
Address validation finalize
Default value is
false
. -
Aftership error
Values are
skip
orerror
. Default value isskip
. -
Allocate draft sales
Values are
enabled
ordisabled
. Default value isenabled
. -
Allocated shipments
Values are
allow
orerror
. Default value isallow
. -
Automatically cancel orders within Onport if they are cancelled within your store. Any dropship purchase orders for the order will also be cancelled.
Default value is
true
. -
Automatically finalize sales
Default value is
true
. -
When publishing products, they'll be automatically available once added to your store. When unchecked, you'll first be able to edit the details in your channel before making them available.
Default value is
true
. -
Blended preference
Values are
dropship
,inhouse
, orrouting
. Default value isinhouse
. -
Bundle inventory sync
Values are
enabled
ordisabled
. Default value isenabled
. -
To ensure faster response times during the checkout process, we have optimized our shipping rate and shipment splitting services. By enabling caching, you can experience faster page loading times. However, please note that enabling caching may temporarily affect the accuracy of shipping prices, as recent adjustments made by the marketplace may not be immediately reflected until the cache expires. If you encounter any discrepancies, change the value here or waiting for the cache to expire.
-
Check dropship at
-
Checkout string
-
Collection endpoint
-
When a new variant is imported from your store, Onport will automatically check to see if an item with the same SKU exists in an inventory feed. The inventory feed must also have the
Automatically connect by SKU
setting enabled. -
Connected at
-
Created at
-
Disable variant inventory sync
-
Dropship provider
-
Dropship routing
Values are
default
orcustom
. Default value isdefault
. -
Email
-
Enable free shipping countries
Default value is
false
. -
Enforce refund limits
Values are
enabled
ordisabled
. Default value isenabled
. -
Eori number
-
Export to shipstation
-
External fulfillment trigger
Values are
onCreate
,onTracking
, oronTransaction
. Default value isonCreate
. -
If you prefer not to finalise sales immediately, you can set a delay for automatic finalisation, or choose 'Manual' to always finalise sales manually.
Values are
manual
or30
. Default value ismanual
. -
Force connect to feed
Default value is
false
. -
Free shipping code
-
Free shipping countries
-
Free shipping name
-
Free shipping origin countries
-
Free shipping override
-
Free shipping scope
Values are
all
,domestic
, orselected
. Default value isall
. -
Free shipping threshold
-
With this option enabled, Variants without a Cost Price will have their inventory level set as 0.
-
Id
-
Image sync
Values are
bidirectional
,jetti
,channel
, orinventoryFeed
. Default value isbidirectional
. -
You might want to set this to 'disabled' if you are using Onport to create in-house labels.
Values are
enabled
ordisabled
. Default value isenabled
. -
Import from feed
-
Import payment status
Values are
unpaid
,partiallyPaid
, orpaid
. Default value ispaid
. -
Import products seconds
-
Include backorder quantity
Default value is
true
. -
Inhouse brand names
-
Inventory feed removed
Values are
all
orpartial
. Default value isall
. -
Inventory feed unpublish
Values are
none
,unpublish
, orunavailable
. Default value isnone
. -
Inventory sync
Values are
all
,inventory_feeds
, ornone
. Default value isall
. -
Control which triggers should send inventory updates to your channel.
Values are
all
orinventoryFeeds
. Default value isall
. -
Lock iso
Default value is
true
. -
Manual sale item routing
Values are
ignore
orpause
. Default value isignore
. -
Max shipping cost
-
Max shipping cost threshold
-
Maximum expected shipping
Values are
enabled
ordisabled
. -
Maximum expected shipping duration
Default value is
0
. -
Name
-
Negative stock
Values are
enabled
ordisabled
. Default value isenabled
. -
Negative stock level
Default value is
0
. -
No rates error
Default value is
false
. -
Option value target
Values are
attributes
,metaFields
, ornone
. Default value isattributes
. -
Order routing
Values are
automated
,manual
, orignore
. Default value isautomated
. -
Order routing endpoint
-
Overselling prevention
Values are
enabled
ordisabled
. Default value isdisabled
. -
Parent channel
Values are
bigCommerce
,custom
,duoplane
,elasticPath
,magento
,manual
,salesforce
,shopify
, orwooCommerce
. Default value ismanual
. -
Pdf legal
-
Phone
-
Price list
-
Products imported at
-
Publish meta fields
-
Publish products
Default value is
true
. -
Publish products without price
Default value is
true
. -
Publish throttle
Values are
product
orchannel
. Default value isproduct
. -
Purchase prefix
-
Purchase status
-
Rate logging
Default value is
false
. -
Require phone number
Default value is
false
. -
Require vendor name
-
This setting controls how shipping rates are distributed among vendors when reverse invoicing is enabled. Reverse invoicing occurs when the vendor invoices the customer instead of the marketplace.
Values are
full
orsplit
. Default value isfull
. -
Routing priority one
Values are
none
,country
,costPrice
, orinStock
. Default value isinStock
. -
Routing priority three
Values are
none
,country
,costPrice
, orinStock
. Default value isnone
. -
Routing priority two
Values are
none
,country
,costPrice
, orinStock
. Default value isnone
. -
Sale custom fields
-
Sale custom fields scope
Values are
all
,selected
, ornone
. Default value isnone
. -
Sale logging
Default value is
false
. -
Sale logging email
Values are
none
,initial
, orall
. Default value isnone
. -
Sale meta field filter
-
Sale meta fields
Values are
all
,selected
, ornone
. Default value isnone
. -
Sale prefix
-
Send shipping notification
Default value is
true
. -
Shipping invoice template
-
Shipstation connected at
-
Shipstation password
-
Shipstation username
-
Skip line items
Default value is
[]
(empty). -
Split shipping
Values are
quantity
,value
,equal
,full
, orfirst
. Default value isfull
. -
Sync address updates
Default value is
true
. -
Sync cost prices
Default value is
false
. -
Sync customer notes
Default value is
true
. -
Sync images
Default value is
true
. -
Sync pricing
Default value is
true
. -
Sync quickbook sales automatically
-
Sync single variant metafields
Values are
product
orvariant
. Default value isvariant
. -
Sync weight zero
Default value is
false
. -
Tax calculation
Values are
channel
,taxRate
, ortaxjar
. Default value ischannel
. -
Tax
-
Tax included
Default value is
true
. -
Tax rate
-
Tax shipping
Default value is
true
. -
Unallocated dropship
Values are
ignore
orpause
. Default value ispause
. -
Unassigned sale items
Values are
include
,exclude
, orblock
. Default value isinclude
. -
Unpublish no inventory
Default value is
false
. -
Updated at
-
Use order routing endpoint
Default value is
false
. -
When publishing products, variant images will also be uploaded, if available.
Default value is
false
. -
Variant import scope
Values are
product
ormapping
. Default value isproduct
. -
Variant logging
Default value is
false
. -
Warehouse
-
Warehouse sync
Values are
default
orall
. Default value isdefault
. -
Weight unit
Values are
g
,kg
,oz
, orlb
. Default value isg
.
curl \
--request PUT 'http://api.example.com/v1/channels/{id}.json' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"addressValidationEndpoint":"string","addressValidationFinalize":false,"aftershipError":"skip","allocateDraftSales":"enabled","allocatedShipments":"allow","automaticallyCancelSales":true,"automaticallyFinalizeSales":true,"automaticallyPublish":true,"blendedPreference":"inhouse","bundleInventorySync":"enabled","cacheRates":42,"checkDropshipAt":"2025-05-04T09:42:00Z","checkoutString":"string","collectionEndpoint":"string","connectToFeed":true,"connectedAt":"2025-05-04T09:42:00Z","createdAt":"2025-05-04T09:42:00Z","disableVariantInventorySync":true,"dropshipAllowTags":[],"dropshipProviderId":42,"dropshipRouting":"default","dropshipRoutingTags":["string"],"dropshipTags":[],"email":"string","enableFreeShippingCountries":false,"enforceRefundLimits":"enabled","eoriNumber":"string","exportToShipstation":true,"externalFulfillmentTrigger":"onCreate","finalizationDelay":"manual","forceConnectToFeed":false,"freeShippingCode":"string","freeShippingCountries":["string"],"freeShippingName":"string","freeShippingOriginCountries":["string"],"freeShippingOverride":true,"freeShippingScope":"all","freeShippingThreshold":42.0,"hash":{},"hideWhenNoCostPrice":true,"id":42,"imageSync":"bidirectional","importChannelFulfillments":"enabled","importFromFeed":true,"importPaymentStatus":"paid","importProductsSeconds":42,"includeBackorderQuantity":true,"includeSaleTags":false,"inhouseBrandNames":["string"],"inventoryFeedRemoved":"all","inventoryFeedUnpublish":"none","inventorySync":"all","inventorySyncTrigger":"all","lockIso":true,"manualSaleItemRouting":"ignore","maxShippingCost":true,"maxShippingCostThreshold":42.0,"maximumExpectedShipping":"enabled","maximumExpectedShippingDuration":0,"name":"string","negativeStock":"enabled","negativeStockLevel":0,"noRatesError":false,"optionValueTarget":"attributes","orderRouting":"automated","orderRoutingEndpoint":"string","oversellingPrevention":"disabled","parentChannel":"manual","pdfLegal":"string","phone":"string","priceListId":42,"productsImportedAt":"2025-05-04T09:42:00Z","publishAdditionalTags":["jetti"],"publishMetaFields":true,"publishProducts":true,"publishProductsWithoutPrice":true,"publishTags":"all","publishThrottle":"product","purchasePrefix":"string","purchaseStatusId":42,"rateLogging":false,"requirePhoneNumber":false,"requireVendorName":true,"reverseSplitShipping":"full","routingPriorityOne":"inStock","routingPriorityThree":"none","routingPriorityTwo":"none","saleCustomFields":["string"],"saleCustomFieldsScope":"none","saleLogging":false,"saleLoggingEmail":"none","saleMetaFieldFilter":["string"],"saleMetaFields":"none","salePrefix":"string","sendShippingNotification":true,"shippingInvoiceTemplate":"string","shipstationConnectedAt":"2025-05-04T09:42:00Z","shipstationPassword":"string","shipstationTags":["string"],"shipstationUrl":{},"shipstationUsername":"string","skipLineItems":[],"skipTags":[],"skipVariantTags":[],"splitShipping":"full","syncAddressUpdates":true,"syncCostPrices":false,"syncCustomerNotes":true,"syncImages":true,"syncPricing":true,"syncQuickbookSalesAutomatically":true,"syncSingleVariantMetafields":"variant","syncWeightZero":false,"taxCalculation":"channel","taxId":"string","taxIncluded":true,"taxRateId":42,"taxShipping":true,"unallocatedDropship":"pause","unassignedSaleItems":"include","unpublishNoInventory":false,"updatedAt":"2025-05-04T09:42:00Z","useOrderRoutingEndpoint":false,"useVariantImage":false,"variantImportScope":"product","variantLogging":false,"warehouseId":42,"warehouseSync":"default","weightUnit":"g"}'
{
"addressValidationEndpoint": "string",
"addressValidationFinalize": false,
"aftershipError": "skip",
"allocateDraftSales": "enabled",
"allocatedShipments": "allow",
"automaticallyCancelSales": true,
"automaticallyFinalizeSales": true,
"automaticallyPublish": true,
"blendedPreference": "inhouse",
"bundleInventorySync": "enabled",
"cacheRates": 42,
"checkDropshipAt": "2025-05-04T09:42:00Z",
"checkoutString": "string",
"collectionEndpoint": "string",
"connectToFeed": true,
"connectedAt": "2025-05-04T09:42:00Z",
"createdAt": "2025-05-04T09:42:00Z",
"disableVariantInventorySync": true,
"dropshipAllowTags": [],
"dropshipProviderId": 42,
"dropshipRouting": "default",
"dropshipRoutingTags": [
"string"
],
"dropshipTags": [],
"email": "string",
"enableFreeShippingCountries": false,
"enforceRefundLimits": "enabled",
"eoriNumber": "string",
"exportToShipstation": true,
"externalFulfillmentTrigger": "onCreate",
"finalizationDelay": "manual",
"forceConnectToFeed": false,
"freeShippingCode": "string",
"freeShippingCountries": [
"string"
],
"freeShippingName": "string",
"freeShippingOriginCountries": [
"string"
],
"freeShippingOverride": true,
"freeShippingScope": "all",
"freeShippingThreshold": 42.0,
"hash": {},
"hideWhenNoCostPrice": true,
"id": 42,
"imageSync": "bidirectional",
"importChannelFulfillments": "enabled",
"importFromFeed": true,
"importPaymentStatus": "paid",
"importProductsSeconds": 42,
"includeBackorderQuantity": true,
"includeSaleTags": false,
"inhouseBrandNames": [
"string"
],
"inventoryFeedRemoved": "all",
"inventoryFeedUnpublish": "none",
"inventorySync": "all",
"inventorySyncTrigger": "all",
"lockIso": true,
"manualSaleItemRouting": "ignore",
"maxShippingCost": true,
"maxShippingCostThreshold": 42.0,
"maximumExpectedShipping": "enabled",
"maximumExpectedShippingDuration": 0,
"name": "string",
"negativeStock": "enabled",
"negativeStockLevel": 0,
"noRatesError": false,
"optionValueTarget": "attributes",
"orderRouting": "automated",
"orderRoutingEndpoint": "string",
"oversellingPrevention": "disabled",
"parentChannel": "manual",
"pdfLegal": "string",
"phone": "string",
"priceListId": 42,
"productsImportedAt": "2025-05-04T09:42:00Z",
"publishAdditionalTags": [
"jetti"
],
"publishMetaFields": true,
"publishProducts": true,
"publishProductsWithoutPrice": true,
"publishTags": "all",
"publishThrottle": "product",
"purchasePrefix": "string",
"purchaseStatusId": 42,
"rateLogging": false,
"requirePhoneNumber": false,
"requireVendorName": true,
"reverseSplitShipping": "full",
"routingPriorityOne": "inStock",
"routingPriorityThree": "none",
"routingPriorityTwo": "none",
"saleCustomFields": [
"string"
],
"saleCustomFieldsScope": "none",
"saleLogging": false,
"saleLoggingEmail": "none",
"saleMetaFieldFilter": [
"string"
],
"saleMetaFields": "none",
"salePrefix": "string",
"sendShippingNotification": true,
"shippingInvoiceTemplate": "string",
"shipstationConnectedAt": "2025-05-04T09:42:00Z",
"shipstationPassword": "string",
"shipstationTags": [
"string"
],
"shipstationUrl": {},
"shipstationUsername": "string",
"skipLineItems": [],
"skipTags": [],
"skipVariantTags": [],
"splitShipping": "full",
"syncAddressUpdates": true,
"syncCostPrices": false,
"syncCustomerNotes": true,
"syncImages": true,
"syncPricing": true,
"syncQuickbookSalesAutomatically": true,
"syncSingleVariantMetafields": "variant",
"syncWeightZero": false,
"taxCalculation": "channel",
"taxId": "string",
"taxIncluded": true,
"taxRateId": 42,
"taxShipping": true,
"unallocatedDropship": "pause",
"unassignedSaleItems": "include",
"unpublishNoInventory": false,
"updatedAt": "2025-05-04T09:42:00Z",
"useOrderRoutingEndpoint": false,
"useVariantImage": false,
"variantImportScope": "product",
"variantLogging": false,
"warehouseId": 42,
"warehouseSync": "default",
"weightUnit": "g"
}