Skip to content

Create a Channel Sellable

POST
/api/v2/channel_sellables

Creates a channel sellable (linked listing) that connects a Veeqo sellable to a channel product listing.

Important: The Accept header must be set to application/vnd.api+json. Omitting this results in a 415 “Unsupported Media Type” error.

object
data
required
object
type
required

Must be “channel_sellables”

string
Allowed values: channel_sellables
attributes
required
object
sellable_id
required

The Veeqo sellable (product variant) ID

string
channel_id
required

The Veeqo channel ID

string
remote_id
required

The remote listing identifier (e.g. Amazon ASIN)

string
remote_sku

The SKU on the remote channel

string
remote_title

The product title on the remote channel

string
channel_product_attributes

Include to create a new channel product and link it to this sellable

object
remote_title

Title for the new channel product

string
relationships

Include to link to an existing channel product instead of creating a new one

object
channel_product
object
data
object
type
string
Allowed values: channel_product
id

The existing channel product ID

string
Example
{
"data": {
"type": "channel_sellables",
"attributes": {
"sellable_id": "111222333",
"channel_id": "1234567",
"remote_id": "B0EXAMPLE123",
"remote_sku": "BLUE-WATER-BOTTLE-500ML",
"remote_title": "Blue Water Bottle 500ml",
"channel_product_attributes": {
"remote_title": "Blue Water Bottle 500ml"
}
}
}
}

Created

object
data
object
id
string
type
string
attributes
object
remote_title
string
remote_sku
string
remote_price
string
currency_code
string
nullable
remote_inventory_quantity
integer
nullable
remote_id
string
active
boolean
relationships
object
channel
object
data
object
id
string
type
string
channel_product
object
data
object
id
string
type
string
sellable
object
data
object
id
string
type
string
Example
{
"data": {
"id": "123456789",
"type": "channel_sellable",
"attributes": {
"remote_title": "Blue Water Bottle 500ml",
"remote_sku": "BLUE-WATER-BOTTLE-500ML",
"remote_price": "0.0",
"currency_code": null,
"remote_inventory_quantity": null,
"remote_id": "B0EXAMPLE123",
"active": true
},
"relationships": {
"channel": {
"data": {
"id": "1234567",
"type": "channel"
}
},
"channel_product": {
"data": {
"id": "987654321",
"type": "channel_product"
}
},
"sellable": {
"data": {
"id": "111222333",
"type": "sellable"
}
}
}
}
}

Unsupported Media Type — returned when Accept header is not set to application/vnd.api+json

Unprocessable Entity — validation errors in the request body