POST /channels.json
Body Required
-
addressValidationEndpoint string | null
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
. -
cacheRates Cache API responses for rates at checkout (seconds}integer(int32) | null
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.
-
checkDropshipAt string(date-time) | null
Check dropship at
-
checkoutString string | null
Checkout string
-
collectionEndpoint string | null
Collection endpoint
-
connectToFeed boolean | null
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. -
connectedAt string(date-time) | null
Connected at
-
disableVariantInventorySync boolean | null
Disable variant inventory sync
-
dropshipProviderId integer(int32) | null
Dropship provider
-
Dropship routing
Values are
default
orcustom
. Default value isdefault
. -
email string | null
Email
-
Enable free shipping countries
Default value is
false
. -
Enforce refund limits
Values are
enabled
ordisabled
. Default value isenabled
. -
eoriNumber string | null
Eori number
-
exportToShipstation boolean | null
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
. -
freeShippingCode string | null
Free shipping code
-
freeShippingCountries array[string] | null
Free shipping countries
-
freeShippingName string | null
Free shipping name
-
freeShippingOriginCountries array[string] | null
Free shipping origin countries
-
freeShippingOverride boolean | null
Free shipping override
-
Free shipping scope
Values are
all
,domestic
, orselected
. Default value isall
. -
freeShippingThreshold number | null
Free shipping threshold
-
hideWhenNoCostPrice boolean | null
With this option enabled, Variants without a Cost Price will have their inventory level set as 0.
-
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
. -
importFromFeed boolean | null
Import from feed
-
Import payment status
Values are
unpaid
,partiallyPaid
, orpaid
. Default value ispaid
. -
importProductsSeconds integer(int32) | null
Import products seconds
-
Include backorder quantity
Default value is
true
. -
inhouseBrandNames array[string] | null
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
. -
maxShippingCost boolean | null
Max shipping cost
-
maxShippingCostThreshold number | null
Max shipping cost threshold
-
maximumExpectedShipping string | null
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
. -
orderRoutingEndpoint string | null
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
. -
pdfLegal string | null
Pdf legal
-
phone string | null
Phone
-
Price list
-
productsImportedAt string(date-time) | null
Products imported at
-
publishMetaFields boolean | null
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
. -
purchasePrefix string | null
Purchase prefix
-
purchaseStatusId integer(int32) | null
Purchase status
-
Rate logging
Default value is
false
. -
Require phone number
Default value is
false
. -
requireVendorName boolean | null
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
. -
saleCustomFields array[string] | null
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
. -
saleMetaFieldFilter array[string] | null
Sale meta field filter
-
Sale meta fields
Values are
all
,selected
, ornone
. Default value isnone
. -
salePrefix string | null
Sale prefix
-
Send shipping notification
Default value is
true
. -
shippingInvoiceTemplate string | null
Shipping invoice template
-
shipstationConnectedAt string(date-time) | null
Shipstation connected at
-
shipstationPassword string | null
Shipstation password
shipstationUrl object | null | array | boolean | integer | number | string
Any of: Shipstation url
Shipstation url
Shipstation url
Shipstation url
Shipstation url
Shipstation url
-
shipstationUsername string | null
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
. -
syncQuickbookSalesAutomatically boolean | null
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
. -
taxId string | null
Tax
-
Tax included
Default value is
true
. -
taxRateId integer(int32) | null
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
. -
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 \
-X POST http://api.example.com/v1/channels.json \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"addressValidationEndpoint":"string","addressValidationFinalize":false,"aftershipError":"skip","allocateDraftSales":"enabled","allocatedShipments":"allow","automaticallyCancelSales":true,"automaticallyFinalizeSales":true,"automaticallyPublish":true,"blendedPreference":"inhouse","bundleInventorySync":"enabled","cacheRates":42,"checkDropshipAt":"2024-05-04T09:42:00+00:00","checkoutString":"string","collectionEndpoint":"string","connectToFeed":true,"connectedAt":"2024-05-04T09:42:00+00:00","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,"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":"2024-05-04T09:42:00+00:00","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":"2024-05-04T09:42:00+00:00","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,"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": "2024-05-04T09:42:00+00:00",
"checkoutString": "string",
"collectionEndpoint": "string",
"connectToFeed": true,
"connectedAt": "2024-05-04T09:42:00+00:00",
"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,
"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": "2024-05-04T09:42:00+00:00",
"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": "2024-05-04T09:42:00+00:00",
"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,
"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": "2024-05-04T09:42:00+00:00",
"checkoutString": "string",
"collectionEndpoint": "string",
"connectToFeed": true,
"connectedAt": "2024-05-04T09:42:00+00:00",
"createdAt": "2024-05-04T09:42:00+00:00",
"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": "2024-05-04T09:42:00+00:00",
"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": "2024-05-04T09:42:00+00:00",
"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": "2024-05-04T09:42:00+00:00",
"useOrderRoutingEndpoint": false,
"useVariantImage": false,
"variantImportScope": "product",
"variantLogging": false,
"warehouseId": 42,
"warehouseSync": "default",
"weightUnit": "g"
}