---
title: Vilkas API Integration on Truto
slug: vilkas
category: E-Commerce
canonical: "https://truto.one/integrations/detail/vilkas/"
---

# Vilkas API Integration on Truto



**Category:** E-Commerce  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 94 tools for Vilkas that AI agents can call directly.

- **vilkas_cart_billing_addresses_bulk_update** — Modifies the billing address for a cart. Required: cart_id.
- **vilkas_cart_billing_addresses_bulk_delete** — Deletes the billing address from a cart. Required: cart_id.
- **create_a_vilkas_cart_coupon** — Applies a coupon code on a cart which results in creating a couponLineItem and a link to remove the coupon. Required: cart_id, code. Documented for ePages 6 shops only; may not be available on Vilkas Now.
- **delete_a_vilkas_cart_coupon_by_id** — Deletes a coupon line item from a specific cart and recalculates cart. The link to add a coupon appears in the links section. Required: id, cart_id. Documented for ePages 6 shops only; may not be available on Vilkas Now.
- **vilkas_cart_line_item_prices_bulk_update** — Modifies the price of a specific product line item in a cart. Required: cart_id, line_item_id.
- **create_a_vilkas_cart_line_item** — Creates a product line item in a cart. Required: cart_id.
- **update_a_vilkas_cart_line_item_by_id** — Modifies a specific product line item in a cart. Required: id, cart_id.
- **delete_a_vilkas_cart_line_item_by_id** — Deletes a specific product line item from a cart. Required: id, cart_id.
- **vilkas_cart_line_items_bulk_create** — Creates multiple product line items in a cart. Required: cart_id.
- **create_a_vilkas_cart_order** — Creates an order that is valid at the time of cart creation. It won't be validated again while processing the actual request. Billing address has to be available in the cart before creating an order. The request body for this REST call remains empty. Required: cart_id.
- **vilkas_cart_payment_data_bulk_update** — Modifies the payment data for a cart.<br><br>Please note that by providing the attribute name in the request body, the attributes paymentMethod and transactionId included in paymentData will be set to null. The provided name will not be included in the response. Required: cart_id.
- **vilkas_cart_shipping_addresses_bulk_update** — Modifies the shipping address for a cart. Required: cart_id.
- **vilkas_cart_shipping_addresses_bulk_delete** — Deletes the shipping address from a cart. Required: cart_id.
- **vilkas_cart_shipping_data_bulk_update** — Modifies the shipping data for a cart. Required: cart_id.
- **list_all_vilkas_carts** — Returns a list of carts. The connector pages through all results (up to 100 per page).
- **create_a_vilkas_cart** — Creates a cart for a shop.
- **get_single_vilkas_cart_by_id** — Returns a specific cart from a shop identified by the provided cart Id. Required: id.
- **list_all_vilkas_categories** — Returns the product categories of the shop. This usually is the default root category "Categories", but can also include additional root categories, if supported by the shop.
- **get_single_vilkas_category_by_id** — Returns the category identified by the provided category ID. Required: id.
- **update_a_vilkas_category_by_id** — Modifies a category identified by the provided category ID. Required: id.
- **delete_a_vilkas_category_by_id** — Deletes a category identified by the provided category ID. Required: id. Documented for ePages 6 shops only; may not be available on Vilkas Now.
- **list_all_vilkas_category_sequences** — Returns the order of subcategories for the provided category ID as an array. If the category has no subcategories, an empty array will be returned. Required: category_id.
- **vilkas_category_sequences_bulk_update** — Updates the order of subcategories for the provided category ID. Note that it is only possible to change the order but not to delete a subcategory. Required: category_id.
- **create_a_vilkas_category_subcategory** — Creates a subcategory to an existing category. Providing attributes in the request is optional. Required: category_id.
- **list_all_vilkas_countries** — Returns all supported countries of the shop, i.e. all countries that can be selected as delivery countries for orders placed in the shop.
- **vilkas_coupon_campaign_coupons_bulk_update** — Creates a coupon code in a coupon campaign. Required: coupon_campaign_id, code.
- **create_a_vilkas_coupon_campaign** — Creates a coupon campaign for a shop. Coupon campaign types can be FIX (absolute value), PERCENT (percentage value), and SHIPPING (waive delivery costs). Required: locale.
- **get_single_vilkas_coupon_campaign_by_id** — Returns a specific coupon campaign from a shop identified by the provided coupon campaign Id. Required: id.
- **list_all_vilkas_currencies** — Returns the currency information of a shop.
- **list_all_vilkas_customers** — Returns a list of all customers. The connector pages through all results (up to 100 per page).
- **create_a_vilkas_customer** — Creates a customer. If *customerNumber* is not provided in the request, it will be generated automatically.
- **get_single_vilkas_customer_by_id** — Returns a specified customer of a shop. Required: id.
- **update_a_vilkas_customer_by_id** — Updates information for a single customer with partial data according to RFC 6902. You can either add or remove certain attributes. <br><br> *Supported JSON-PATCH operations*<br> - add (sets or replaces an attribute)<br> - remove (unsets an attribute)<br><br> *Attribute paths that allow updates via PATCH* ( ¹ supports *add* only)<br> - /customerNumber¹<br> - /billingAddress<br> - /internalNote<br>. Required: id. Send a JSON Patch array (RFC 6902) as the body.
- **list_all_vilkas_legal** — Returns hyperlinks of legal information for a shop.
- **list_all_vilkas_legal_contact_information** — Returns the contact information of a shop.
- **vilkas_legal_contact_information_bulk_update** — Modifies the contact information of a shop. This endpoint expects a complete object representation, all fields included. If any field is not set, it will be deleted from the transferred object. Required: locale.
- **list_all_vilkas_legal_cookie_policy** — Returns the cookie policy of a shop.
- **vilkas_legal_cookie_policy_bulk_update** — Modifies the cookie policy of a shop. This endpoint expects a complete object representation, all fields included. If any field is not set, it will be deleted from the transferred object. Required: locale.
- **list_all_vilkas_legal_privacy_policy** — Returns the privacy policy of a shop.
- **vilkas_legal_privacy_policy_bulk_update** — Modifies the privacy policy of a shop. This endpoint expects a complete object representation, all fields included. If any field is not set, it will be deleted from the transferred object. Required: locale.
- **list_all_vilkas_legal_rights_of_withdrawal** — Returns the customer rights of withdrawal of a shop.
- **vilkas_legal_rights_of_withdrawal_bulk_update** — Modifies the customer rights of withdrawal of a shop. This endpoint expects a complete object representation, all fields included. If any field is not set, it will be deleted from the transferred object. Required: locale.
- **list_all_vilkas_legal_shipping_information** — Returns detailed information on possible shipping types and the costs incurred. Also displays the costs for shipment abroad.
- **vilkas_legal_shipping_information_bulk_update** — Modifies the shipping information of a shop. This endpoint expects a complete object representation, all fields included. If any field is not set, it will be deleted from the transferred object. Required: locale.
- **list_all_vilkas_legal_terms_and_conditions** — Returns the terms and conditions of a shop.
- **vilkas_legal_terms_and_conditions_bulk_update** — Modifies the terms and conditions of a shop. This endpoint expects a complete object representation, all fields included. If any field is not set, it will be deleted from the transferred object. Required: locale.
- **list_all_vilkas_locales** — Returns the shop's locale information, i.e. the language identifier and the region identifier.
- **list_all_vilkas_newsletter_campaign_subscribers** — Returns all subscribers of a newsletter campaign from a shop. Required: campaign_id. Documented for ePages 6 shops only; may not be available on Vilkas Now. The connector pages through all results (up to 100 per page).
- **list_all_vilkas_newsletter_campaigns** — Returns all newsletter campaigns of a shop. Documented for ePages 6 shops only; may not be available on Vilkas Now. The connector pages through all results (up to 100 per page).
- **list_all_vilkas_order_documents** — Returns finalized invoice and credit note order documents by orderId. Required: order_id. The connector pages through all results (up to 100 per page).
- **list_all_vilkas_orders** — Returns a list of orders. By default the results for orders are sorted by creationDate. The connector pages through all results (up to 100 per page).
- **get_single_vilkas_order_by_id** — Returns information for a single order identified by the provided order ID. Required: id.
- **update_a_vilkas_order_by_id** — Updates information for a single order with partial data according to RFC 6902. You can either add or remove certain attributes. Note that an order cannot be updated once it is in edit mode. In that case, response code 409 will appear. Required: id. Send a JSON Patch array (RFC 6902) as the body.
- **create_a_vilkas_product_availability_notification** — Enables the availability notification for the given product and customer email address. The language of the notification is based on the locale of the customer's storefront. Required: product_id.
- **create_a_vilkas_product_category_assignment** — Assigns categories to products and products to categories. Required: categoryId, productId.
- **vilkas_product_category_assignments_bulk_delete** — Deletes one or more products from a category. Required: categoryId, productId. Documented for ePages 6 shops only; may not be available on Vilkas Now.
- **list_all_vilkas_product_cross_selling** — Returns information on the cross-selling assignments of a single product. Required: product_id.
- **vilkas_product_cross_selling_bulk_update** — Modifies information on the cross-selling assignments of a single product by replacing all of the assignments. Required: product_id.
- **vilkas_product_cross_selling_bulk_patch** — Updates information on the cross-selling assignments for a single product with partial data according to RFC 6902. You can either add or remove assignments. Required: product_id.
- **list_all_vilkas_product_custom_attributes** — Returns values of user-defined product attributes. Required: product_id.
- **vilkas_product_custom_attributes_bulk_update** — Updates information on the custom attributes for a single product with partial data according to RFC 6902. You can either add or remove assignments. <br><br> *Supported JSON-PATCH operations*<br> - add (sets or replaces an attribute value)<br> - remove (unsets an attribute)<br><br>. Required: product_id.
- **list_all_vilkas_product_exports** — Returns a CSV file with all products of the shop. Note that after the first installation of the app by a merchant, the export file will not be available until the next day.
- **list_all_vilkas_product_lowest_prices** — Returns the lowest price of all variations of a product that can currently be purchased.<br> Returns 404 Not Found if the product does not have any variation with an independent price, e.g. if all variations share the same price. Also depends on the shop setting to display "from" prices. Required: product_id. Documented for ePages 6 shops only; may not be available on Vilkas Now.
- **list_all_vilkas_product_slideshow_images** — Returns links to the slideshow images of a product. Slideshow images are all images uploaded for a product. Required: product_id.
- **create_a_vilkas_product_slideshow_image** — Creates (uploads) an image for the product slideshow. The product slideshow reflects all images uploaded for the product. To determine the slideshow image that should serve as the main image for the product, refer to the respective PATCH endpoint. Required: product_id, filename, name, image.
- **delete_a_vilkas_product_slideshow_image_by_id** — Deletes a single image from the product slideshow. The product slideshow reflects all images uploaded for the product. Required: id, product_id.
- **list_all_vilkas_product_slideshow_sequences** — Returns the names of the slideshow images as an array. Slideshow images are all images uploaded for the product. They are displayed in the same order as they are included in the array. Required: product_id.
- **vilkas_product_slideshow_sequences_bulk_update** — Updates the sequence of the slideshow images. Slideshow images are all images uploaded for the product. They will be displayed in the same order as they are provided in the array. Required: product_id.
- **list_all_vilkas_product_suggestions** — Returns suggestions for a product search query. Required: query. Documented for ePages 6 shops only; may not be available on Vilkas Now.
- **list_all_vilkas_product_types** — Returns a list of all product types. The connector pages through all results (up to 100 per page).
- **create_a_vilkas_product_type** — Creates a product type.
- **get_single_vilkas_product_type_by_id** — Returns a specified product type of a shop. Required: id.
- **update_a_vilkas_product_type_by_id** — Updates information for a single product type with partial data according to RFC 6902. You can either add or remove certain attributes. Required: id. Send a JSON Patch array (RFC 6902) as the body.
- **list_all_vilkas_product_variations** — Returns a list of product variations.<br/> The response contains links to the listed product variations and the attributes name and value that were used for creating those variations. Note that the default amount of results per page is 100. The maximum amount of results displayed per page is 1000 for this resource. Required: product_id. Documented for ePages 6 shops only; may not be available on Vilkas Now. The connector pages through all results (up to 1000 per page).
- **create_a_vilkas_product_variation** — Creates new product variations. Required: product_id.
- **list_all_vilkas_products** — Returns a list of products. The connector pages through all results (up to 100 per page).
- **create_a_vilkas_product** — Creates a new product.
- **get_single_vilkas_product_by_id** — Returns information on a single product. For product variations, a link to the respective product variations resource (rel="variations") is added. Note that the attribute minStocklevel is only available with the products_write authorisation. Required: id.
- **update_a_vilkas_product_by_id** — Updates information for a single product with partial data according to RFC 6902. You can either add or remove certain attributes. Required: id. Send a JSON Patch array (RFC 6902) as the body.
- **delete_a_vilkas_product_by_id** — Deletes a single product. Required: id.
- **vilkas_products_lookup** — Returns a list of products that match a specified SKU.
- **vilkas_products_search** — Performs a product search using facets.
- **list_all_vilkas_sales** — Returns the summary of sales figures for a specified product or for the shop grouped by currencies. The amounts are gross and net amounts. By default the results of the last 30 days are displayed. Open-ended queries are limited to 30 days. The maximum time frame for displaying orders is 1 year.
- **list_all_vilkas_script_tags** — Returns a list of all script tags for a shop.
- **create_a_vilkas_script_tag** — Creates a new script tag.
- **delete_a_vilkas_script_tag_by_id** — Deletes a script tag identified by the provided script tag ID. Using this call, only deletes the script tags created by an application, not all the script tags of a shop. Required: id.
- **list_all_vilkas_shipping_methods** — Returns the shipping methods of a shop.
- **get_single_vilkas_shipping_method_by_id** — Returns a specific shipping method of a shop identified by the provided shipping method Id. Required: id.
- **list_all_vilkas_shop_info** — Returns the public information of a shop, like name, slogan and logo.
- **list_all_vilkas_tax_classes** — Returns all tax classes of a shop. The connector pages through all results (up to 100 per page).
- **get_single_vilkas_tax_class_by_id** — Returns a specific tax class of a shop identified by the provided tax class Id. Required: id.
- **list_all_vilkas_tax_model** — Returns the tax model of the shop.
- **list_all_vilkas_updated_products** — Returns all updated products together with the time of their last update. Required: product_property.
- **list_all_vilkas_watched_products** — Returns a list of all watched products. Watched products refers to items currently out of stock and therefore can be watched by online shop customers. The connector pages through all results (up to 100 per page).

## How it works

1. **Link your customer's Vilkas account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Vilkas.** The Proxy API is a 1-to-1 mapping of the Vilkas API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Automate Nordic order fulfillment** — Shipping and logistics SaaS can poll new Vilkas orders, generate labels with carriers like Posti or Matkahuolto, and push tracking data back to the merchant's shop so end users get a hands-off fulfillment flow.
- **Sync product catalogs from a PIM** — PIM and catalog management tools can push products, variations, custom attributes, and category assignments into Vilkas, keeping a merchant's storefront in lockstep with their master catalog without manual data entry.
- **Embed storefront widgets safely** — Reviews, chat, personalization, and analytics SaaS can inject their JavaScript into Vilkas shops via script tags, so merchants onboard with one click instead of pasting code into templates.
- **Run loyalty and retention campaigns** — Retention platforms can segment Vilkas customers by order history, then auto-create coupon campaigns with single-use codes to reward VIPs or recover abandoned carts.
- **Mirror orders into ERP and accounting** — ERP, bookkeeping, and finance SaaS can pull orders, order documents (invoices, credit notes), and customer data from Vilkas to keep financial systems reconciled with live shop activity.

## What you can build

- **Two-way order and tracking sync** — List new Vilkas orders, enrich them in your app, and patch shipping data or order status back using the bulk shipping and order update endpoints.
- **One-click storefront script installer** — Install and uninstall your widget cleanly on any Vilkas shop by programmatically creating and deleting script tags, no merchant code edits required.
- **Catalog push from a PIM** — Create products, variations, slideshow images, cross-sells, and category assignments in Vilkas directly from your product information system.
- **Automated coupon and campaign engine** — Spin up coupon campaigns and bulk-generate single-use codes tied to triggers like VIP tiers, re-engagement, or abandoned carts.
- **Customer segmentation and CRM sync** — Pull the full customer list with order history to build audiences, score LTV, and sync enriched profiles into marketing or CRM destinations.
- **Invoice and document ingestion** — Fetch finalized order documents such as invoices and credit notes to feed accounting, tax, and audit workflows in your SaaS.

## FAQs

### How does authentication to Vilkas work through Truto?

Vilkas is built on the ePages REST API and uses token-based authentication scoped to a merchant's shop. Truto handles the credential exchange and storage so your end users connect their Vilkas shop once and your app calls the tools without managing tokens directly.

### Which Vilkas resources can I read and write today?

The available tools cover carts, orders, order documents, customers, products (including variations, custom attributes, cross-selling, and slideshow images), categories and category sequences, coupons and coupon campaigns, script tags, shipping methods, tax classes, legal pages, newsletters, and shop metadata.

### How do I keep order and product data fresh?

You can poll endpoints like list_all_vilkas_orders, list_all_vilkas_updated_products, and list_all_vilkas_customers on a schedule. Truto normalizes pagination so you can incrementally sync without re-implementing per-endpoint cursors.

### Can I update orders partially instead of replacing the whole record?

Yes. Order updates use JSON-PATCH semantics via update_a_vilkas_order_by_id, which is ideal for patching fulfillment status, tracking numbers, or shipping data without overwriting other fields.

### How do I install my app's frontend code on a merchant's Vilkas storefront?

Use create_a_vilkas_script_tag to inject your JavaScript into the storefront, and delete_a_vilkas_script_tag_by_id to remove it on uninstall. This is the supported way to embed widgets without editing shop templates.

### Does Truto support bulk operations for Vilkas?

Yes. Several Vilkas tools are bulk-native, including cart line items, shipping and billing addresses, product custom attributes, cross-selling, category sequences, coupon campaign coupons, and legal content updates, so you can push large changesets efficiently.

### Are custom product attributes supported?

Yes. You can list and bulk-update product custom attributes, which is useful for B2B specs, SKUs with extended metadata, or industry-specific fields that go beyond the default product schema.
