BeezUP integration
BeezUP is a product feed and marketplace order management platform for online merchants. Manage stores, push, merge or delete catalog products, run and schedule catalog imports, send catalogs to channels (enable, cost settings, product overrides, exclusions), publish to marketplaces, list and change marketplace orders (accept, ship, cancel), push orders to your URL, generate invoices, read click and sales analytics, run optimisation rules and read change logs. Not exposed: sign-up, login and account, password and billing management, the manual import wizard, column, category and exclusion filter editing, mocked replication and legacy tracking routes, Product Vision, report previews, and routes that only answer gzip-compressed or by redirect. Authentication is the BeezUP API token (My Account page) sent in the Ocp-Apim-Subscription-Key header.
Say what should happen.
The workflow builds itself.
What you can do with BeezUP
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Store, 6 operations
create_storeCreate storePOSTCreates a store from a unique name, its website URL, its country (alpha-3 code from list StoreCountryWithInternational) and its sectors (codes from list ParamSector, see get_list_of_values).delete_storeDelete storeDELETEDeletes a store from the account.get_storeGet storeGETReturns one store: name, URL, country, currency, sectors, your role on it, status, owner, offer, share count and creation date.list_store_change_logsList store change logsPOSTLists the configuration changes made on a store in one change log domain (see list_change_log_domains), with a continuation token for the next page.list_storesList storesGETLists the stores of the account (a store is one product catalog sent to channels): id, name, URL, country, currency, sectors, your role, status, offer and creation date.update_storeUpdate storePATCHUpdates a store's name, URL, sectors and international flag. The country of a store cannot be changed.
Product, 5 operations
get_catalog_productGet catalog productGETReturns one catalog product by its BeezUP product id: category, whether it still exists in the catalog, and its column values.get_catalog_product_by_skuGet catalog product by skuGETReturns one catalog product by its SKU: BeezUP product id, category, whether it still exists in the catalog, and its column values.get_channel_catalog_productGet channel catalog productGETReturns one product's state in a channel catalog: SKU, title, image, whether it exists, is disabled, uncategorized or excluded (and by which filters), and its overridden values.get_product_in_channel_catalogsGet product in channel catalogsPOSTReturns one product's state in several channel catalogs of a store (overrides, disabled, uncategorized, excluded), keyed by channel catalog id.list_channel_catalog_productsList channel catalog productsPOSTLists the products of a channel catalog page by page with their state on the channel (overridden, disabled, uncategorized, excluded and by which filter), filtered by visibility criteria, SKUs or categories.
Rule, 5 operations
create_ruleCreate rulePOSTCreates an optimisation rule that disables or reenables the products matching a saved report filter, optionally only between two dates.delete_ruleDelete ruleDELETEDeletes an optimisation rule.get_ruleGet ruleGETReturns one optimisation rule: name, action, report filter, position, enabled flag, validity dates and last execution status and date.list_rulesList rulesGETLists a store's optimisation rules: name, action (disable or reenable products), report filter, position, enabled flag, validity dates and last execution.update_ruleUpdate rulePATCHRenames an optimisation rule and changes its validity dates.
Channel catalog, 4 operations
create_channel_catalogCreate channel catalogPOSTAdds a channel to a store by creating its channel catalog (channelId from list_channels).delete_channel_catalogDelete channel catalogDELETEDeletes a channel catalog, removing the channel from the store.get_channel_catalogGet channel catalogGETReturns a channel catalog: channel, store, enabled flag, marketplace flag, general, cost and category settings, column mappings, exclusion filters, export URL and state.list_channel_catalogsList channel catalogsGETLists your channel catalogs (a store's catalog configured for one channel), optionally for one store, keyed by channel catalog id.
History, 4 operations
get_order_change_reportGet order change reportGETReturns the report of one order change request: type, processing status, dates, error message, test mode, details and the messages exchanged with the marketplace.list_channel_catalog_exportationsList channel catalog exportationsGETLists the past exportations of a channel catalog, page by page: date, duration, cache status, exported product count, and the client IP address and user agent.list_marketplace_publicationsList marketplace publicationsGETReturns the publication history of a marketplace account, newest first (10 by default): publication type, dates, status and each feed's result.list_order_historyList order historyGETReturns an order's history: every change request (type, status, who, when, messages exchanged with the marketplace) and every harvest of the order.
Subscription, 4 operations
create_order_subscriptionCreate order subscriptionPOSTCreates an order subscription under the GUID you pass as id: BeezUP will push orders to targetUrl once it is activated with activate_order_subscription.delete_order_subscriptionDelete order subscriptionDELETEDeletes an order subscription.get_order_subscriptionGet order subscriptionGETReturns an order subscription: status, target URL, application name and version, recovery period, last pushed order date and last error.list_order_subscriptionsList order subscriptionsGETLists your order subscriptions: BeezUP pushes the orders of your stores to a URL you host.
Disable, 3 operations
disable_channel_catalogDisable channel catalogPOSTDisables a channel catalog so its products stop being exported to the channel.disable_channel_catalog_productDisable channel catalog productPOSTStops exporting one product to a channel (every catalog product is exported by default). For many products, the vendor recommends the optimisation tools.disable_ruleDisable rulePOSTDisables an optimisation rule.
General, 3 operations
get_invoice_settingsGet invoice settingsGETReturns the order invoice settings: language, product and shipping VAT rates, invoice prefix, starting sequence number and last number used.update_channel_catalog_general_settingsUpdate channel catalog general settingsPUTSets a channel catalog's general settings: whether out-of-stock products are exported, whether BeezUP tracking is active, and whether your click and sales statistics may be disclosed.update_invoice_settingsUpdate invoice settingsPUTSets the order invoice settings: language (culture name), product and shipping VAT rates, invoice prefix and starting sequence number.
Harvest, 3 operations
harvest_account_ordersHarvest account ordersPOSTAsks BeezUP to fetch the orders of one marketplace account now, or a single order of it by marketplace order id or BeezUP order id.harvest_all_ordersHarvest all ordersPOSTAsks BeezUP to fetch new and updated orders from every marketplace account now (optionally of one store), instead of waiting for the next scheduled harvest.harvest_orderHarvest orderPOSTAsks BeezUP to fetch one order from its marketplace again now.
Importation, 3 operations
get_importationGet importationGETReturns the status of one catalog importation of a store: success, begin and last update dates, the steps of the process and any errors.list_importationsList importationsGETLists the latest catalog importations of a store: execution id, step, success, product totals, errors, dates and whether it was automatic.list_importations_all_storesList importations all storesGETReturns the latest catalog importation reports of every store of the account, keyed by store id.
Product batch, 3 operations
delete_productsDelete productsDELETEPushes up to 1,000 product SKUs to delete from a store's catalog. The import starts after a one-minute delay or once 50 batches are waiting.merge_productsMerge productsPATCHPushes up to 1,000 products whose fields are merged into a store's catalog (a field cannot be removed this way; use replace_products). The import starts after one minute or once 50 batches wait.replace_productsReplace productsPUTPushes up to 1,000 products to add or replace in a store's catalog (each product's fields replace the stored ones). The import starts after a one-minute delay or once 50 batches are waiting.
Status, 3 operations
get_order_synchronization_statusGet order synchronization statusGETReturns the order synchronization status: the last completed order harvest date of each marketplace account.get_store_tracking_statusGet store tracking statusGETReturns the dates up to which clicks, orders and marketplace orders are synchronized in the analytics of one store.get_tracking_statusGet tracking statusGETReturns the dates up to which clicks, orders and marketplace orders are synchronized in the analytics (they are eventually consistent), for the whole account.
Activate, 2 operations
activate_auto_importActivate auto importPOSTTurns the last successful manual catalog importation of a store into an automatic one, so the catalog is fetched again on a schedule. No parameter besides the store is needed.activate_order_subscriptionActivate order subscriptionPOSTActivates an order subscription: BeezUP first verifies the target URL, then pushes orders, optionally recovering existing orders modified within a past period.
Auto import, 2 operations
delete_auto_importDelete auto importDELETEDeletes the automatic catalog import of a store.get_auto_importGet auto importGETReturns a store's automatic catalog import configuration: input, scheduling type and value, time zone, whether it is paused, and who changed it.
Bycategory, 2 operations
get_report_by_categoryGet report by categoryPOSTReturns a store's performance per catalog category over a period: clicks, cost, orders, sales, margin, ROI and product counts, filterable and sortable, paged.optimise_category_productsOptimise category productsPOSTDisables or reenables the products of one catalog category on the channel given in the body.
Bychannel, 2 operations
get_report_by_channelGet report by channelPOSTReturns a store's performance per channel over a period: clicks, cost, orders, sales, margin, ROI and product counts, filterable by category and indicator thresholds, sortable and paged.optimise_channel_productsOptimise channel productsPOSTDisables or reenables every product of a store on one channel.
Byday, 2 operations
get_report_by_dayGet report by dayPOSTReturns a store's daily performance over a period: clicks, cost, orders, total sales and margin per day, for all channels and per channel, plus the period's overall performance indicator.get_report_by_day_all_storesGet report by day all storesPOSTReturns the daily performance report (clicks, cost, orders, sales, margin) of every store over a period, keyed by store id, optionally for some channels, a product or a category.
Byproduct, 2 operations
get_report_by_productGet report by productPOSTReturns a store's performance per product over a period: clicks, cost, orders, sales, margin and ROI, filterable by product state, category, column values and indicator thresholds, paged.optimise_productOptimise productPOSTDisables or reenables one product on the channel given in the body.
Channel, 2 operations
get_channelGet channelGETReturns a channel's description: name, logo, description, BeezUP offer, key numbers, details (costs, business model, type, tracking, home page) and sales and technical contacts.list_channelsList channelsGETLists the channels (marketplaces, comparison shopping engines, ad networks) available for a store, with their id, name, logo and types.
Clear merchant order info, 2 operations
clear_merchant_order_infoClear merchant order infoPOSTRemoves your own order id and e-commerce software information from an order.clear_merchant_order_infosClear merchant order infosPOSTRemoves your own order id and software information from up to 100 orders in one call. Returns the result of each operation.
Design, 2 operations
get_invoice_designGet invoice designGETReturns the HTML header and footer printed on order invoices.update_invoice_designUpdate invoice designPUTSets the HTML header and footer printed on order invoices.
Enable, 2 operations
enable_channel_catalogEnable channel catalogPOSTEnables a channel catalog so its products are exported to the channel.enable_ruleEnable rulePOSTEnables an optimisation rule.
Exportation, 2 operations
export_ordersExport ordersPOSTRequests a CSV report of a store's orders matching a filter (purchase or modification period of at most 62 days, marketplaces, statuses...). Follow its progress and file with list_order_exportations.list_order_exportationsList order exportationsGETLists a store's order report exportations page by page: status, order count, dates, and the download link and expiry of each generated file.
Generate, 2 operations
generate_order_invoiceGenerate order invoicePOSTGenerates the invoice of one order (accepted asynchronously), optionally with a given invoice sequence number.generate_order_invoicesGenerate order invoicesPOSTGenerates the invoices of several orders in one call, each optionally with its sequence number. Returns the result of each.
Override, 2 operations
delete_product_overrideDelete product overrideDELETERemoves the override of one channel column on one product of a channel catalog, so the catalog value is exported again.set_product_overridesSet product overridesPUTOverrides values of one product for one channel catalog only (for example another title or price on that channel), keyed by channel column id.
Run, 2 operations
run_ruleRun rulePOSTRuns one optimisation rule now.run_rulesRun rulesPOSTRuns every optimisation rule of a store now.
Set merchant order info, 2 operations
set_merchant_order_infoSet merchant order infoPOSTLinks an order to your own order id and e-commerce software (name and version), so BeezUP knows it was imported into your system.set_merchant_order_infosSet merchant order infosPOSTLinks up to 100 orders to your own order ids in one call, with your e-commerce software name and version. Returns the result of each operation.
User, 2 operations
list_user_change_logsList user change logsPOSTLists the configuration changes made by a user (userId from get_account) across all domains, with a continuation token for the next page.list_user_change_logs_by_domainList user change logs by domainPOSTLists the configuration changes made by a user in one change log domain, with a continuation token for the next page.
V3, 2 operations
change_orderChange orderPOSTChanges an order on its marketplace (accept, ship, cancel...): changeOrderType and the body fields come from the order's transitionLinks in get_order. Accepted asynchronously; check list_order_history.get_orderGet orderGETReturns one order with its items, buyer and shipping addresses, totals, statuses, etag and transitionLinks: the change types allowed now and the fields each needs for change_order.
Account, 1 operation
get_accountGet accountGETReturns the BeezUP user behind the API key: user id (used by the change log tools), email, status, personal and company information, and the commercial owner and customer success contacts.
Automatic transition, 1 operation
list_automatic_transitionsList automatic transitionsGETLists the automatic order status transitions configured (for example accepting orders automatically), per marketplace account, with whether each is enabled.
Beez upcolumn, 1 operation
get_beezup_column_mappingGet beezup column mappingGETReturns which catalog column of a store feeds each BeezUP column.
Beezup column, 1 operation
list_beezup_columnsList beezup columnsGETLists the standard BeezUP columns (product id, title, price, image and so on) that catalog columns are mapped to when a catalog is imported, with their importance, data type and whether each must be unique.
Cancel, 1 operation
cancel_importationCancel importationPOSTCancels a catalog importation that is in progress.
Catalog column, 1 operation
list_catalog_columnsList catalog columnsGETLists the columns detected in a store's catalog, with the BeezUP column each one is mapped to.
Category, 1 operation
list_channel_catalog_categoriesList channel catalog categoriesGETLists the category mapping of a channel catalog (each catalog category path with the channel category it is mapped to and its cost), and the mapping and cost statuses.
Change order, 1 operation
change_ordersChange ordersPOSTSends up to 100 order changes (accept, ship, cancel...) in one call, each with its order, change type and change fields. Returns the result of each operation.
Channelcatalog, 1 operation
list_marketplace_channel_catalogsList marketplace channel catalogsGETLists your marketplace channel catalogs (channel catalogs connected to a marketplace account), optionally for one store, with marketplace code, account id and API settings status.
Click, 1 operation
list_tracked_clicksList tracked clicksGETReturns the latest tracked clicks of a store: date, channel, product and IP address.
Close incident, 1 operation
close_order_incidentClose order incidentPOSTMarks an order incident as resolved, with a closing reason code.
Copy, 1 operation
copy_optimisationsCopy optimisationsPOSTCopies the product optimisations (which products are disabled) of one channel to another, optionally keeping the target's existing ones. Returns the target's product counts.
Cost, 1 operation
update_channel_catalog_cost_settingsUpdate channel catalog cost settingsPUTSets how a channel catalog's cost is computed: per click (CPC) or per action (CPA), global or by category, or fixed, with the global cost value when it applies.
Counter, 1 operation
get_channel_catalog_product_countersGet channel catalog product countersGETReturns a channel catalog's product counters: existing, uncategorized, disabled and excluded products.
Custom column, 1 operation
list_custom_columnsList custom columnsGETLists a store's custom columns (columns computed by an expression from catalog columns), with their mapping and the catalog columns they depend on.
Deactivate, 1 operation
deactivate_order_subscriptionDeactivate order subscriptionPOSTDeactivates an order subscription; no more orders are pushed.
Domain, 1 operation
list_change_log_domainsList change log domainsGETLists the change log domains (store lifecycle, channel lifecycle, category and column mapping, exclusion filters, order harvest and so on) the change log tools filter on.
Exclusion filter, 1 operation
list_exclusion_filtersList exclusion filtersGETLists the exclusion filters of a channel catalog: the conditions on product values that keep products from being exported to the channel.
Execution, 1 operation
list_rule_executionsList rule executionsGETLists the executions of a store's optimisation rules page by page: rule, action, dates, status and the number of products and channels affected.
Externalorder, 1 operation
list_tracked_external_ordersList tracked external ordersGETReturns the latest tracked external orders of a store: merchant order id, date, visitor id, amount, payment status and products.
Filter operator, 1 operation
list_filter_operatorsList filter operatorsGETLists the operators exclusion filters can use, with the column and value types each expects and whether a value is required.
Get pdf invoice, 1 operation
get_invoice_pdfGet invoice pdfPOSTReturns the PDF file of an order invoice from its invoice URI (order_Invoice_Uri in get_order).
Interval, 1 operation
set_auto_import_intervalSet auto import intervalPOSTSchedules a store's automatic catalog import at a fixed interval, given as a time span (04:00:00 imports every 4 hours).
Light, 1 operation
list_ordersList ordersPOSTLists marketplace orders page by page over a period of at most 62 days (by purchase or modification date), filtered by marketplace, account, store, status, buyer or order ids: order headers without items.
List, 1 operation
list_catalog_productsList catalog productsPOSTLists a store's catalog products page by page, filtered by SKU, EAN, MPN, title, product ids, category path or whether they still exist, with the column values you ask for.
Lov, 1 operation
get_list_of_valuesGet list of valuesGETReturns a BeezUP list of values (codes with their translated labels), such as the store countries, sectors, time zones, marketplace codes or order change types other tools ask for.
Order, 1 operation
list_tracked_ordersList tracked ordersGETReturns the latest tracked orders of a store: merchant order id, date, amount, payment status, channel and products (price, quantity, margin).
Order management ready marketplace business code, 1 operation
list_order_ready_marketplacesList order ready marketplacesGETLists the marketplace business codes whose orders BeezUP can manage, optionally for given stores.
Pause, 1 operation
pause_auto_importPause auto importPOSTPauses the automatic catalog import of a store.
Publish, 1 operation
publish_to_marketplacePublish to marketplacePOSTLaunches a publication of the catalog to a marketplace account: a feed type (products, inventory, pricing...) with the Delta (recommended), Full or Unpublish strategy.
Random, 1 operation
list_random_productsList random productsGETReturns 10 randomly selected products of a store's catalog with all their values, to look at a sample of the catalog.
Reenable, 1 operation
reenable_channel_catalog_productReenable channel catalog productPOSTExports a previously disabled product to the channel again.
Report, 1 operation
get_importation_reportGet importation reportGETReturns the report of a catalog importation: columns and categories created, updated, deleted or unchanged, product counts (detected, active, duplicated, failed) and errors.
Reporting, 1 operation
list_order_subscription_pushesList order subscription pushesGETLists the order pushes made for a subscription, page by page: date, order count, HTTP status and error of each.
Resume, 1 operation
resume_auto_importResume auto importPOSTResumes a paused automatic catalog import of a store.
Retry, 1 operation
retry_order_subscriptionRetry order subscriptionPOSTRetries pushing orders immediately for an active subscription whose target was unavailable, instead of waiting for the next scheduled retry.
Schedule, 1 operation
set_auto_import_schedulesSet auto import schedulesPOSTSchedules a store's automatic catalog import at given times of day (21:00:00 imports at 9 PM), in a local time zone (Romance Standard Time when omitted).
Setting, 1 operation
get_marketplace_settingsGet marketplace settingsGETReturns the marketplace settings of a marketplace channel catalog, each with its name, value type and value.
Start, 1 operation
start_auto_importStart auto importPOSTStarts the automatic catalog import of a store now, outside its schedule.
Use BeezUP from Claude Code, Cursor or Codex
Connect BeezUP in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its BeezUP operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect BeezUP
- Create your workspace
Sign up free. Nothing to install.
- Connect BeezUP once
Add your BeezUP connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
BeezUP integration FAQ
What can you do with the BeezUP integration?
LiveContext exposes 119 operations on BeezUP, covering store, product, rule and channel catalog.
