Products

Creating, reading, updating and deleting products

PreviousOrders NextProduct groups

Last updated 1 year ago

Was this helpful?

Get products

get

Gets the products from a store and returns them as a paginated response, requires the Scopes.ViewProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store to get the products for

pageinteger · int32required

The page to select when viewing the products

Query parameters

countinteger · int32optional

The amount of products to display in one page

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{page}' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "pages": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "dateCreated": "2025-04-03T08:08:13.687Z",
      "name": "text",
      "description": "text",
      "cost": 1,
      "amountSold": 1,
      "files": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "dateCreated": "2025-04-03T08:08:13.687Z",
          "friendlyName": "text"
        }
      ],
      "tags": [
        "text"
      ],
      "webhookUrl": "text",
      "visibility": 0,
      "isPinned": true,
      "isDynamic": true,
      "imageNames": [
        "text"
      ],
      "ignoreOutOfStock": true,
      "customValueKeys": [
        "text"
      ],
      "shouldBlockVirtualPrivateNetworks": true,
      "category": "text",
      "deliveryMessage": "text",
      "minimumQuantity": 1,
      "maximumQuantity": 1,
      "order": 1,
      "likes": 1,
      "isBestSeller": true,
      "blacklistedPaymentGateways": [
        "text"
      ],
      "additionalFees": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "metadata": "text"
    }
  ]
}

The object was successfully returned.

Get product by ID

get

Finds and returns a product by it's ID, requires the Scopes.ViewProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product to get

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "cost": 1,
    "amountSold": 1,
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "friendlyName": "text"
      }
    ],
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "visibility": 0,
    "isPinned": true,
    "isDynamic": true,
    "imageNames": [
      "text"
    ],
    "ignoreOutOfStock": true,
    "customValueKeys": [
      "text"
    ],
    "shouldBlockVirtualPrivateNetworks": true,
    "category": "text",
    "deliveryMessage": "text",
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "order": 1,
    "likes": 1,
    "isBestSeller": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "metadata": "text"
  }
}

The object was successfully returned.

Remove image from product

delete

Removes an image from a product, uses the file name of the image used to access it from S3, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product the image belongs to

fileNamestringrequired

The file name of the image to remove

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/image/{fileName}' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "tags": [
      "text"
    ],
    "imageNames": [
      "text"
    ],
    "imageLinks": [
      "text"
    ],
    "cost": 1,
    "stock": 1,
    "amountSold": 1,
    "ignoreOutOfStock": true,
    "isPinned": true,
    "isDynamic": true,
    "store": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "dateCreated": "2025-04-03T08:08:13.687Z",
      "name": "text",
      "description": "text",
      "url": "text",
      "customDomain": "text",
      "termsOfService": "text",
      "copyright": "text",
      "privacyPolicy": "text",
      "preferredCurrency": "text",
      "isVerified": true,
      "featuredProduct": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "name": "text",
        "description": "text",
        "tags": [
          "text"
        ],
        "imageNames": [
          "text"
        ],
        "cost": 1,
        "stock": 1,
        "amountSold": 1,
        "ignoreOutOfStock": true,
        "isPinned": true,
        "isDynamic": true,
        "rating": 1,
        "minimumQuantity": 1,
        "maximumQuantity": 1,
        "order": 1,
        "visibility": 0,
        "likes": 1,
        "customValueKeys": [
          "text"
        ],
        "store": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "dateCreated": "2025-04-03T08:08:13.687Z",
          "name": "text",
          "description": "text",
          "url": "text",
          "customDomain": "text",
          "termsOfService": "text",
          "copyright": "text",
          "privacyPolicy": "text",
          "preferredCurrency": "text",
          "isVerified": true,
          "featuredProduct": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "dateCreated": "2025-04-03T08:08:13.687Z",
            "name": "text",
            "description": "text",
            "tags": [
              "text"
            ],
            "imageNames": [
              "text"
            ],
            "cost": 1,
            "stock": 1,
            "amountSold": 1,
            "ignoreOutOfStock": true,
            "isPinned": true,
            "isDynamic": true,
            "rating": 1,
            "minimumQuantity": 1,
            "maximumQuantity": 1,
            "order": 1,
            "visibility": 0,
            "likes": 1,
            "customValueKeys": [
              "text"
            ],
            "store": "[Circular Reference]"
          },
          "visits": 1,
          "reviews": 1,
          "rating": 1,
          "resolvedTickets": 1,
          "productsSold": 1,
          "theme": {
            "properties": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            }
          },
          "socialMediaAccounts": {
            "tikTok": "text",
            "youTube": "text",
            "twitter": "text",
            "facebook": "text",
            "discord": "text",
            "telegram": "text",
            "instagram": "text"
          },
          "profileImage": "text"
        }
      },
      "visits": 1,
      "reviews": 1,
      "rating": 1,
      "resolvedTickets": 1,
      "productsSold": 1,
      "theme": {
        "properties": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "socialMediaAccounts": {
        "tikTok": "text",
        "youTube": "text",
        "twitter": "text",
        "facebook": "text",
        "discord": "text",
        "telegram": "text",
        "instagram": "text"
      },
      "profileImage": "text"
    },
    "reviews": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "rating": 1,
        "reason": "text",
        "productId": "123e4567-e89b-12d3-a456-426614174000",
        "reply": "text"
      }
    ],
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "category": "text",
    "deliveryMessage": "text",
    "blacklistedPaymentGateways": [
      "text"
    ],
    "rating": 1,
    "shouldBlockVirtualPrivateNetworks": true,
    "customValueKeys": [
      "text"
    ],
    "order": 1,
    "likes": 1,
    "visibility": 0,
    "isBestSeller": true,
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
}

The object was successfully deleted.

Remove file from product

delete

Removes a file from the product and deletes it's link on S3, this means that users who have already been delivered a link to the file will lose it. Requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product the file belongs to

fileIdstring · uuidrequired

The ID of the file to remove

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/file/{fileId}' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "cost": 1,
    "amountSold": 1,
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "friendlyName": "text"
      }
    ],
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "visibility": 0,
    "isPinned": true,
    "isDynamic": true,
    "imageNames": [
      "text"
    ],
    "ignoreOutOfStock": true,
    "customValueKeys": [
      "text"
    ],
    "shouldBlockVirtualPrivateNetworks": true,
    "category": "text",
    "deliveryMessage": "text",
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "order": 1,
    "likes": 1,
    "isBestSeller": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "metadata": "text"
  }
}

The object was successfully deleted.

Get product by ID

get

Gets and returns a product by it's ID, does not require authorization nor a store ID but will return a public product instead which redacts sensitive information

Authorizations

Path parameters

productIdstring · uuidrequired

The ID of the product to get

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sellsn.io/products/{productId}/view' \
  --header 'Authorization: Bearer JWT'

200

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "tags": [
      "text"
    ],
    "imageNames": [
      "text"
    ],
    "imageLinks": [
      "text"
    ],
    "cost": 1,
    "stock": 1,
    "amountSold": 1,
    "ignoreOutOfStock": true,
    "isPinned": true,
    "isDynamic": true,
    "store": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "dateCreated": "2025-04-03T08:08:13.687Z",
      "name": "text",
      "description": "text",
      "url": "text",
      "customDomain": "text",
      "termsOfService": "text",
      "copyright": "text",
      "privacyPolicy": "text",
      "preferredCurrency": "text",
      "isVerified": true,
      "featuredProduct": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "name": "text",
        "description": "text",
        "tags": [
          "text"
        ],
        "imageNames": [
          "text"
        ],
        "cost": 1,
        "stock": 1,
        "amountSold": 1,
        "ignoreOutOfStock": true,
        "isPinned": true,
        "isDynamic": true,
        "rating": 1,
        "minimumQuantity": 1,
        "maximumQuantity": 1,
        "order": 1,
        "visibility": 0,
        "likes": 1,
        "customValueKeys": [
          "text"
        ],
        "store": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "dateCreated": "2025-04-03T08:08:13.687Z",
          "name": "text",
          "description": "text",
          "url": "text",
          "customDomain": "text",
          "termsOfService": "text",
          "copyright": "text",
          "privacyPolicy": "text",
          "preferredCurrency": "text",
          "isVerified": true,
          "featuredProduct": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "dateCreated": "2025-04-03T08:08:13.687Z",
            "name": "text",
            "description": "text",
            "tags": [
              "text"
            ],
            "imageNames": [
              "text"
            ],
            "cost": 1,
            "stock": 1,
            "amountSold": 1,
            "ignoreOutOfStock": true,
            "isPinned": true,
            "isDynamic": true,
            "rating": 1,
            "minimumQuantity": 1,
            "maximumQuantity": 1,
            "order": 1,
            "visibility": 0,
            "likes": 1,
            "customValueKeys": [
              "text"
            ],
            "store": "[Circular Reference]"
          },
          "visits": 1,
          "reviews": 1,
          "rating": 1,
          "resolvedTickets": 1,
          "productsSold": 1,
          "theme": {
            "properties": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            }
          },
          "socialMediaAccounts": {
            "tikTok": "text",
            "youTube": "text",
            "twitter": "text",
            "facebook": "text",
            "discord": "text",
            "telegram": "text",
            "instagram": "text"
          },
          "profileImage": "text"
        }
      },
      "visits": 1,
      "reviews": 1,
      "rating": 1,
      "resolvedTickets": 1,
      "productsSold": 1,
      "theme": {
        "properties": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "socialMediaAccounts": {
        "tikTok": "text",
        "youTube": "text",
        "twitter": "text",
        "facebook": "text",
        "discord": "text",
        "telegram": "text",
        "instagram": "text"
      },
      "profileImage": "text"
    },
    "reviews": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "rating": 1,
        "reason": "text",
        "productId": "123e4567-e89b-12d3-a456-426614174000",
        "reply": "text"
      }
    ],
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "category": "text",
    "deliveryMessage": "text",
    "blacklistedPaymentGateways": [
      "text"
    ],
    "rating": 1,
    "shouldBlockVirtualPrivateNetworks": true,
    "customValueKeys": [
      "text"
    ],
    "order": 1,
    "likes": 1,
    "visibility": 0,
    "isBestSeller": true,
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
}

The object was successfully returned.

Get product reviews

get

Gets and returns the paginated and public reviews for a product, does not require authorization

Authorizations

Path parameters

productIdstring · uuidrequired

The ID of the product to get the reviews for

pageinteger · int32 · default: 1required

The page to select when viewing the reviews

Query parameters

countinteger · int32 · default: 15optional

The amount of reviews to display in one page

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sellsn.io/product/{productId}/view/reviews/{page}' \
  --header 'Authorization: Bearer JWT'

200

404

text/plain

application/json

text/json

{
  "success": true,
  "pages": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "dateCreated": "2025-04-03T08:08:13.687Z",
      "rating": 1,
      "reason": "text",
      "productId": "123e4567-e89b-12d3-a456-426614174000",
      "reply": "text"
    }
  ]
}

The object was successfully returned.

Get product items

get

Gets the items associated with a product which will be given on delivery, requires the Scopes.ViewProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product to get the items from

pageinteger · int32required

The page to select when viewing the items

Query parameters

countinteger · int32optional

The amount of items to display in one page

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/items/{page}' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "pages": 1,
  "data": [
    "text"
  ]
}

The object was successfully returned.

Clear product items

delete

Clears and completely resets the items associated with a product, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product whose items should be cleared

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/items/clear' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": null
}

The operation was successfully completed.

Get all products

get

Gets all the products in a store, does not use pagination but in turn only returns a reference which redacts a lot of data from the product. Requires the Scopes.ViewProducts permissions

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store to get all the products for

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sellsn.io/stores/{storeId}/products' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "dateCreated": "2025-04-03T08:08:13.687Z",
      "name": "text",
      "description": "text",
      "tags": [
        "text"
      ],
      "imageNames": [
        "text"
      ],
      "cost": 1,
      "stock": 1,
      "amountSold": 1,
      "ignoreOutOfStock": true,
      "isPinned": true,
      "isDynamic": true,
      "rating": 1,
      "minimumQuantity": 1,
      "maximumQuantity": 1,
      "order": 1,
      "visibility": 0,
      "likes": 1,
      "customValueKeys": [
        "text"
      ],
      "store": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "name": "text",
        "description": "text",
        "url": "text",
        "customDomain": "text",
        "termsOfService": "text",
        "copyright": "text",
        "privacyPolicy": "text",
        "preferredCurrency": "text",
        "isVerified": true,
        "featuredProduct": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "dateCreated": "2025-04-03T08:08:13.687Z",
          "name": "text",
          "description": "text",
          "tags": [
            "text"
          ],
          "imageNames": [
            "text"
          ],
          "cost": 1,
          "stock": 1,
          "amountSold": 1,
          "ignoreOutOfStock": true,
          "isPinned": true,
          "isDynamic": true,
          "rating": 1,
          "minimumQuantity": 1,
          "maximumQuantity": 1,
          "order": 1,
          "visibility": 0,
          "likes": 1,
          "customValueKeys": [
            "text"
          ],
          "store": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "dateCreated": "2025-04-03T08:08:13.687Z",
            "name": "text",
            "description": "text",
            "url": "text",
            "customDomain": "text",
            "termsOfService": "text",
            "copyright": "text",
            "privacyPolicy": "text",
            "preferredCurrency": "text",
            "isVerified": true,
            "featuredProduct": "[Circular Reference]",
            "visits": 1,
            "reviews": 1,
            "rating": 1,
            "resolvedTickets": 1,
            "productsSold": 1,
            "theme": {
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": "text"
              }
            },
            "socialMediaAccounts": {
              "tikTok": "text",
              "youTube": "text",
              "twitter": "text",
              "facebook": "text",
              "discord": "text",
              "telegram": "text",
              "instagram": "text"
            },
            "profileImage": "text"
          }
        },
        "visits": 1,
        "reviews": 1,
        "rating": 1,
        "resolvedTickets": 1,
        "productsSold": 1,
        "theme": {
          "properties": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        },
        "socialMediaAccounts": {
          "tikTok": "text",
          "youTube": "text",
          "twitter": "text",
          "facebook": "text",
          "discord": "text",
          "telegram": "text",
          "instagram": "text"
        },
        "profileImage": "text"
      }
    }
  ]
}

The object was successfully returned.

Create product

post

Creates a new product in the given store, requires the Scopes.CreateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store to create the product in

Body

namestring · min: 3 · max: 64required

The name of the product, this is displayed publicly on the store page and marketplace

costnumber · doublerequired

The cost of the product

ignoreOutOfStockbooleanoptional

Whether the system should ignore if the product is "Out of stock" and allow purchasing the product anyway, mandatory for dynamic products

isDynamicbooleanoptional

Whether the product is a dynamic product type, in this case the response from the webhook will dictate the item

tagsstring[] | nullableoptional

The tags on the product, very helpful for boosting the products SEO on the marketplace

webhookUrlstring | nullableoptional

The webhook URL to send dynamic product requests and just delivery notifications to

descriptionstring | nullableoptional

The description of the product, supports markdown and images from Imgur only

visibilityinteger · enumrequired

List of product visibility (or privacy) levels

Available options:

deliveryMessagestring | nullableoptional

The message to put on the completed delivery email when the product has been delivered

customValueKeysstring[] | nullableoptional

The custom field names to prompt the user with when buying the product

minimumQuantityinteger · int32 · min: 1 · max: 100000optional

The minimum quantity required to buy the product, defaults to 1

maximumQuantityinteger · int32 · min: -1 · max: 100000optional

The maximum quantity the user is allowed to buy for the product, -1 = no limit

shouldBlockVirtualPrivateNetworksbooleanoptional

Whether VPNs and proxies are blocked from purchasing the product, very good for Stripe

blacklistedPaymentGatewaysstring[] | nullableoptional

The array of blacklisted payment methods for the specific product, must be a valid SellSN payment method ID

isBestSellerbooleanoptional

Whether the product should be marked as a best seller on the users store page, does nothing for the marketplace

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.sellsn.io/stores/{storeId}/products' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "cost": 1,
    "ignoreOutOfStock": true,
    "isDynamic": true,
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "description": "text",
    "visibility": 0,
    "deliveryMessage": "text",
    "customValueKeys": [
      "text"
    ],
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "shouldBlockVirtualPrivateNetworks": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "isBestSeller": true
  }'

200

400

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "cost": 1,
    "amountSold": 1,
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "friendlyName": "text"
      }
    ],
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "visibility": 0,
    "isPinned": true,
    "isDynamic": true,
    "imageNames": [
      "text"
    ],
    "ignoreOutOfStock": true,
    "customValueKeys": [
      "text"
    ],
    "shouldBlockVirtualPrivateNetworks": true,
    "category": "text",
    "deliveryMessage": "text",
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "order": 1,
    "likes": 1,
    "isBestSeller": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "metadata": "text"
  }
}

The object was successfully created.

Update product

put

Updates a product in a store, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product to update

Body

namestring · min: 3 · max: 64required

The name of the product, this is displayed publicly on the store page and marketplace

costnumber · doublerequired

The cost of the product

ignoreOutOfStockbooleanoptional

Whether the system should ignore if the product is "Out of stock" and allow purchasing the product anyway, mandatory for dynamic products

isDynamicbooleanoptional

Whether the product is a dynamic product type, in this case the response from the webhook will dictate the item

tagsstring[] | nullableoptional

The tags on the product, very helpful for boosting the products SEO on the marketplace

webhookUrlstring | nullableoptional

The webhook URL to send dynamic product requests and just delivery notifications to

descriptionstring | nullableoptional

The description of the product, supports markdown and images from Imgur only

visibilityinteger · enumrequired

List of product visibility (or privacy) levels

Available options:

deliveryMessagestring | nullableoptional

The message to put on the completed delivery email when the product has been delivered

customValueKeysstring[] | nullableoptional

The custom field names to prompt the user with when buying the product

minimumQuantityinteger · int32 · min: 1 · max: 100000optional

The minimum quantity required to buy the product, defaults to 1

maximumQuantityinteger · int32 · min: -1 · max: 100000optional

The maximum quantity the user is allowed to buy for the product, -1 = no limit

shouldBlockVirtualPrivateNetworksbooleanoptional

Whether VPNs and proxies are blocked from purchasing the product, very good for Stripe

blacklistedPaymentGatewaysstring[] | nullableoptional

The array of blacklisted payment methods for the specific product, must be a valid SellSN payment method ID

isBestSellerbooleanoptional

Whether the product should be marked as a best seller on the users store page, does nothing for the marketplace

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "cost": 1,
    "ignoreOutOfStock": true,
    "isDynamic": true,
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "description": "text",
    "visibility": 0,
    "deliveryMessage": "text",
    "customValueKeys": [
      "text"
    ],
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "shouldBlockVirtualPrivateNetworks": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "isBestSeller": true
  }'

200

No body

Success

Set custom fee

put

Sets a custom fee for a specific product in a store, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store that the product belongs to

productIdstring · uuidrequired

The ID of the product to set the fees for

Body

paymentMethodstring · min: 1required

The payment method to set the fee percentage for, must be a valid SellSN payment method ID

feePercentagenumber · double | nullableoptional

The fee percentage to apply for the specific payment method, leave as null to remove the existing fee

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/fees' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "paymentMethod": "text",
    "feePercentage": 1
  }'

200

400

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": null
}

The object was successfully updated.

Add image to product

patch

Adds a new image to the product, the image must be PNG, JPG, WebP or GIF and below 30 megabytes in size, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product to add the image to

Body

imagestring · binaryoptional

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PATCH \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/image' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: multipart/form-data' \
  --form 'image=binary'

200

400

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "cost": 1,
    "amountSold": 1,
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "friendlyName": "text"
      }
    ],
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "visibility": 0,
    "isPinned": true,
    "isDynamic": true,
    "imageNames": [
      "text"
    ],
    "ignoreOutOfStock": true,
    "customValueKeys": [
      "text"
    ],
    "shouldBlockVirtualPrivateNetworks": true,
    "category": "text",
    "deliveryMessage": "text",
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "order": 1,
    "likes": 1,
    "isBestSeller": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "metadata": "text"
  }
}

The object was successfully created.

Add file to product

patch

Adds a file to the product, there can only be one file uploaded to a product at a time for delivery and this will replace any existing file, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product the file should be uploaded to

Body

filestring · binaryoptional

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PATCH \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/file' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=binary'

200

400

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "dateCreated": "2025-04-03T08:08:13.687Z",
    "name": "text",
    "description": "text",
    "cost": 1,
    "amountSold": 1,
    "files": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2025-04-03T08:08:13.687Z",
        "friendlyName": "text"
      }
    ],
    "tags": [
      "text"
    ],
    "webhookUrl": "text",
    "visibility": 0,
    "isPinned": true,
    "isDynamic": true,
    "imageNames": [
      "text"
    ],
    "ignoreOutOfStock": true,
    "customValueKeys": [
      "text"
    ],
    "shouldBlockVirtualPrivateNetworks": true,
    "category": "text",
    "deliveryMessage": "text",
    "minimumQuantity": 1,
    "maximumQuantity": 1,
    "order": 1,
    "likes": 1,
    "isBestSeller": true,
    "blacklistedPaymentGateways": [
      "text"
    ],
    "additionalFees": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "metadata": "text"
  }
}

The object was successfully created.

Add items to product

put

Adds a list of items to the given product, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product the items should be added to

Body

itemsstring[] | nullableoptional

The array of items to add to the product, this will append the items to the end of the existing items

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/items' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "items": [
      "text"
    ]
  }'

200

400

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": null
}

The object was successfully created.

Remove items from product

delete

Removes all the items in the given form from the product, requires the Scopes.UpdateProducts permission

Authorizations

Path parameters

storeIdstring · uuidrequired

The ID of the store the product belongs to

productIdstring · uuidrequired

The ID of the product to remove the items from

Body

itemsstring[] | nullableoptional

The array of items to add to the product, this will append the items to the end of the existing items

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'https://api.sellsn.io/stores/{storeId}/products/{productId}/items' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "items": [
      "text"
    ]
  }'

200

400

401

403

404

text/plain

application/json

text/json

{
  "success": true,
  "message": "text",
  "data": null
}

The object was successfully deleted.