The Simla.com connector lets your AI agent act in each user's Simla.com account. Each user connects their own Simla.com API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 55 tools.
- Tools
- 55
- What they doRead · write · destructive
- 41 · 13 · 141 read13 write1 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Simla.com connection
In AgentKit > Connections, create a Simla.com connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'simla'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Simla.com:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'simla_corporate_customers_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "simla"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Simla.com:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="simla_corporate_customers_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Simla.com credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolsimla_corporate_customer_getGet one Simla corporate customer by external ID (or internal ID with by=id).Read-onlyGet Corporate Customer
Get one Simla corporate customer by external ID (or internal ID with by=id). Returns the corporate customer with companies, contact persons, addresses and manager. Use this for a company's details.
Inputs
external_idstringrequired- Customer ID. Example: ext-1001.
bystring- Is specified what is transmitted in parameter externalId: internal (by=id) or external (by=externalId) ID. By default it is externalId. Example: externalId.one of
idexternalId sitestring- Symbolic code of store. Is specified in case of handling by externalId (by=externalId). Example: main-store.
simla_corporate_customers_listList Simla corporate customers (companies).Read-onlyList Corporate Customers
List Simla corporate customers (companies). Returns corporate customers with ID, external ID, nickname, companies, contacts and manager. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_citystring- City. Example: Sofia.
filter_namestring- Customer. Example: Jane.
filter_regionstring- Region. Example: Sofia City.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_couriers_listList the couriers configured in Simla.Read-onlyList Couriers
List the couriers configured in Simla. Returns couriers with ID, name, phone and active flag. Use this to assign couriers to deliveries.
Inputs
This tool takes no inputs.
simla_credentials_getGet the API methods and stores the Simla API key can access.Read-onlyGet API Key Permissions
Get the API methods and stores the Simla API key can access. Returns the allowed scopes, stores (sites) and the system version. Use this to check the connection and the key's permissions first.
Inputs
This tool takes no inputs.
simla_currencies_listList the currencies configured in Simla.Read-onlyList Currencies
List the currencies configured in Simla. Returns currencies with code, base flag and exchange rate settings. Use this to check currencies used by stores.
Inputs
This tool takes no inputs.
simla_custom_fields_listList the custom fields defined in Simla for orders, customers and other entities.Read-onlyList Custom Fields
List the custom fields defined in Simla for orders, customers and other entities. Returns fields with code, name, entity and type. Use this to find custom field codes for create and update calls.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100250 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_customer_getGet one Simla customer by external ID (or internal ID with by=id).Read-onlyGet Customer
Get one Simla customer by external ID (or internal ID with by=id). Returns the customer's full record: names, contacts, address, manager, tags, custom fields and order stats. Use this for a customer's details.
Inputs
external_idstringrequired- Customer ID. Example: ext-1001.
bystring- Is specified what is transmitted in parameter externalId: internal (by=id) or external (by=externalId) customer ID. By default it is externalId. Example: externalId.one of
idexternalId sitestring- Symbolic code of store. Example: main-store.
simla_customer_notes_listList notes on Simla customers, filtered by text or creation date.Read-onlyList Customer Notes
List notes on Simla customers, filtered by text or creation date. Returns notes with ID, text, customer, manager and date. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_created_at_fromstring- Date/time of creation (from). Example: 2026-10-01 00:00:00.
filter_created_at_tostring- Date/time of creation (to). Example: 2026-10-31 23:59:59.
filter_textstring- Note text. Example: call back.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_customers_history_listList changes made to Simla customers, oldest first, optionally for one customer or a date range.Read-onlyList Customer History
List changes made to Simla customers, oldest first, optionally for one customer or a date range. Returns history records with field, old and new values, source and user. Use this to sync customer changes incrementally with filter_since_id.
Inputs
filter_customer_external_idstring- Customer external ID. Example: cust-2201.
filter_customer_idinteger- Customer ID. Example: 2201.
filter_end_datestring- End DateTime of change. Example: 2026-10-31 23:59:59.
filter_since_idinteger- Starting with customers history ID. Example: 1.
filter_start_datestring- Start DateTime of change. Example: 2026-10-01 00:00:00.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_customers_listList Simla customers (individuals), filtered by name, email, city, registration date, segment or other fields.Read-onlyList Customers
List Simla customers (individuals), filtered by name, email, city, registration date, segment or other fields. Returns customers with ID, external ID, names, contacts, address, order stats and pagination. Use limit 20, 50 or 100 and page to move through results. Use simla_customer_get for one customer.
Inputs
filter_badboolean- BAD customer. Example: true.
filter_citystring- City. Example: Sofia.
filter_date_fromstring- Registration date (from). Example: 2026-10-01.
filter_date_tostring- Registration date (to). Example: 2026-10-31.
filter_emailstring- E-mail. Example: jane@example.com.
filter_min_orders_countinteger- Orders count (from). Example: 10.
filter_namestring- Customer. Example: Jane.
filter_regionstring- Region. Example: Sofia City.
filter_segmentstring- Segment. Example: vip-buyers.
filter_vipboolean- VIP customer. Example: true.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_delivery_services_listList the delivery services configured in Simla.Read-onlyList Delivery Services
List the delivery services configured in Simla. Returns services with code, name and delivery type. Use this to get delivery service codes.
Inputs
This tool takes no inputs.
simla_delivery_types_listList the delivery types configured in Simla.Read-onlyList Delivery Types
List the delivery types configured in Simla. Returns delivery types with code, name, default cost and allowed payment types. Use this to get delivery codes for orders.
Inputs
This tool takes no inputs.
simla_inventories_listList Simla stock balances and purchase prices of offers per warehouse.Read-onlyList Inventories
List Simla stock balances and purchase prices of offers per warehouse. Returns offers with stock quantity per store and purchase price. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_detailsboolean- Return the details for stock balance. Defaults to false. Example: true.
filter_offer_activeboolean- Return the stock balance only for active SKUs. Example: true.
filter_product_activeboolean- Return the stock balance only for active products. Example: true.
filter_product_external_idstring- Product external ID. Example: prod-77.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100250 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_knowledge_base_documents_listList the Simla knowledge base documents.Read-onlyList Knowledge Base Documents
List the Simla knowledge base documents. Returns documents with ID, title, section and dates. Use this to find help articles for support.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100
simla_offers_listList Simla offers (SKUs), filtered by name, article or barcode, price type, activity or price.Read-onlyList Offers
List Simla offers (SKUs), filtered by name, article or barcode, price type, activity or price. Returns offers with ID, external ID, name, article, barcode, prices and quantity. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_activeboolean- Activity. Example: True.one of
truefalse filter_max_priceinteger- Offer price (to). Example: 100.
filter_min_priceinteger- Offer price (from). Example: 10.
filter_namestring- Name/article of the product or article/barcode of the offer. Example: Jane.
filter_price_typestring- Price type. Example: base.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_order_getGet one Simla order by external ID (or internal ID with by=id).Read-onlyGet Order
Get one Simla order by external ID (or internal ID with by=id). Returns the order with status, customer, items, totals, delivery, payments and custom fields. Use this for an order's details.
Inputs
external_idstringrequired- Order ID. Example: ext-1001.
bystring- Is specified what is transmitted in parameter externalId: internal (by=id) or external (by=externalId) order ID. By default it is externalId. Example: externalId.one of
idexternalId sitestring- Symbolic code of store. Example: main-store.
simla_order_methods_listList the order methods (channels) configured in Simla, such as shopping cart or phone.Read-onlyList Order Methods
List the order methods (channels) configured in Simla, such as shopping cart or phone. Returns methods with code and name. Use this to get orderMethod codes.
Inputs
This tool takes no inputs.
simla_order_packs_listList Simla order packs (items reserved and packed from a warehouse).Read-onlyList Order Packs
List Simla order packs (items reserved and packed from a warehouse). Returns packs with ID, order item, store, quantity and shipment date. Use limit 20, 50 or 100 and page to move through results.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_order_types_listList the order types configured in Simla.Read-onlyList Order Types
List the order types configured in Simla. Returns order types with code and name. Use this to get orderType codes.
Inputs
This tool takes no inputs.
simla_orders_history_listList changes made to Simla orders, oldest first, optionally for one order or a date range.Read-onlyList Order History
List changes made to Simla orders, oldest first, optionally for one order or a date range. Returns history records with field, old and new values, source and user. Use this to sync order changes incrementally with filter_since_id.
Inputs
filter_end_datestring- End DateTime of change. Example: 2026-10-31 23:59:59.
filter_order_external_idstring- Order external ID. Example: ext-1001.
filter_order_idinteger- Order ID. Example: 1501.
filter_since_idinteger- Starting with orders history ID. Example: 1.
filter_start_datestring- Start DateTime of change. Example: 2026-10-01 00:00:00.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_orders_listList Simla orders, filtered by customer, email, product, region or other fields.Read-onlyList Orders
List Simla orders, filtered by customer, email, product, region or other fields. Returns orders with ID, number, status, customer, items, totals, delivery and payments, plus pagination. Use limit 20, 50 or 100 and page to move through results. Use simla_order_get for one order.
Inputs
filter_callboolean- Call required. Example: true.
filter_customerstring- Customer (Name or phone number). Example: Jane Doe.
filter_customer_external_idstring- Customer external ID. Example: cust-2201.
filter_customer_idinteger- Customer ID. Example: 2201.
filter_emailstring- E-mail. Example: jane@example.com.
filter_expiredboolean- Order expired. Example: true.
filter_productstring- Product (title or article). Example: Hoodie.
filter_regionstring- Region. Example: Sofia City.
filter_vipboolean- VIP customer. Example: true.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_payment_statuses_listList the payment statuses configured in Simla.Read-onlyList Payment Statuses
List the payment statuses configured in Simla. Returns statuses with code and name. Use this to get payment status codes.
Inputs
This tool takes no inputs.
simla_payment_types_listList the payment types configured in Simla.Read-onlyList Payment Types
List the payment types configured in Simla. Returns payment types with code, name and allowed statuses. Use this to get payment type codes for orders.
Inputs
This tool takes no inputs.
simla_price_types_listList the price types configured in Simla.Read-onlyList Price Types
List the price types configured in Simla. Returns price types with code, name and default flag. Use this to get price type codes for simla_prices_upload.
Inputs
This tool takes no inputs.
simla_product_groups_listList Simla product groups (catalog categories).Read-onlyList Product Groups
List Simla product groups (catalog categories). Returns groups with ID, external ID, name, parent and site. Use limit 20, 50 or 100 and page to move through results.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_products_listList Simla catalog products and their SKUs (offers), filtered by name or article, manufacturer, external ID, price, quantity or activity.Read-onlyList Products
List Simla catalog products and their SKUs (offers), filtered by name or article, manufacturer, external ID, price, quantity or activity. Returns products with ID, name, article, prices, quantities, groups and offers. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_activeboolean- Activity. Example: true.
filter_external_idstring- External ID. Example: prod-77.
filter_manufacturerstring- Manufacturer. Example: Acme.
filter_max_priceinteger- Price of product (to). Example: 100.
filter_min_priceinteger- Price of product (from). Example: 10.
filter_namestring- Name/article of the product or article/barcode of the SKU. Example: Jane.
filter_since_updated_atstring- Lower limit on the date of product change (excluding the border). Example: 2026-10-01 00:00:00.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_segments_listList the Simla customer segments.Read-onlyList Customer Segments
List the Simla customer segments. Returns segments with ID, code, name, size and whether they are dynamic. Use limit 20, 50 or 100 and page to move through results.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_shipments_listList Simla shipments to delivery services.Read-onlyList Shipments
List Simla shipments to delivery services. Returns shipments with ID, delivery service, orders, status and dates. Use limit 20, 50 or 100 and page to move through results.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_sites_listList the stores (sites) configured in Simla.Read-onlyList Stores
List the stores (sites) configured in Simla. Returns each store's code, name, URL, currency and settings. Use this to get the site codes other tools need.
Inputs
This tool takes no inputs.
simla_status_groups_listList the order status groups in Simla, such as new, approval, assembling, delivery and complete.Read-onlyList Order Status Groups
List the order status groups in Simla, such as new, approval, assembling, delivery and complete. Returns groups with code, name and their statuses. Use this to understand the order workflow.
Inputs
This tool takes no inputs.
simla_statuses_listList the order statuses configured in Simla.Read-onlyList Order Statuses
List the order statuses configured in Simla. Returns each status's code, name, group and order. Use this to get status codes for simla_order_update.
Inputs
This tool takes no inputs.
simla_task_comments_listList the comments on a Simla task.Read-onlyList Task Comments
List the comments on a Simla task. Returns comments with text, author and date. Use this to read the discussion on a task.
Inputs
idintegerrequired- Task ID. Example: 1501.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_task_getGet one Simla task.Read-onlyGet Task
Get one Simla task. Returns the task's text, commentary, due time, performer, status and linked order or customer. Use this for a task's details.
Inputs
idintegerrequired- Task ID. Example: 1501.
simla_tasks_listList Simla tasks for managers, filtered by status, priority, text, linked order, ticket or customer, or dates.Read-onlyList Tasks
List Simla tasks for managers, filtered by status, priority, text, linked order, ticket or customer, or dates. Returns tasks with ID, text, commentary, due time, performer, status and links. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_customer_idinteger- Customer ID related to the task. Example: 2201.
filter_date_fromstring- Task execution date (from). Example: 2026-10-01.
filter_date_tostring- Task execution date (to). Example: 2026-10-31.
filter_order_idinteger- Order ID related to the task. Example: 1501.
filter_order_numberstring- Number of order, related to the task. Example: 1501A.
filter_prioritystring- Task priority. Example: low.one of
lowmediumhigh filter_statusstring- Task status. Example: expired.one of
expiredcompletedperforming filter_textstring- Task text. Example: call back.
filter_ticket_idinteger- Ticket ID related to the task. Example: 42.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_ticket_comments_listList Simla ticket comments, filtered by text or dates; paged with a cursor.Read-onlyList Ticket Comments
List Simla ticket comments, filtered by text or dates; paged with a cursor. Returns comments with text, ticket, author and date, plus the next cursor. Use this to read ticket discussions.
Inputs
cursorstring- The cursor of the element from which the search starts. Example: eyJpZCI6MTAwfQ.
filter_created_at_fromstring- Created at or after this date and time. Example: 2026-10-01 00:00:00.
filter_created_at_tostring- Created at or before this date and time. Example: 2026-10-31 23:59:59.
filter_textstring- Case-insensitive text substring. Example: call back.
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100
simla_ticket_getGet one Simla ticket by external ID (or internal ID with by=id).Read-onlyGet Ticket
Get one Simla ticket by external ID (or internal ID with by=id). Returns the ticket with description, customer, issues, status, topic and custom fields. Use this for a ticket's details.
Inputs
external_idstringrequired- External or internal ticket ID. Example: ext-1001.
bystring- Ticket identifier type. Defaults to externalId. Example: externalId.one of
idexternalId sitestring- Symbolic code of store. Example: main-store.
simla_tickets_listList Simla support tickets, newest first, filtered by state, SLA, customer, email, text or dates; paged with a cursor.Read-onlyList Tickets
List Simla support tickets, newest first, filtered by state, SLA, customer, email, text or dates; paged with a cursor. Returns tickets with ID, number, state, customer, topic, issues and dates, plus the next cursor. Use this to review support work. Pass the returned cursor to get the next page.
Inputs
cursorstring- The cursor of the element from which the search starts. Example: eyJpZCI6MTAwfQ.
filter_commentsstring- Comment text. Example: refund.
filter_created_at_fromstring- Creation date from. Example: 2026-10-01 00:00:00.
filter_created_at_tostring- Creation date to. Example: 2026-10-31 23:59:59.
filter_customerstring- Customer search. Example: Jane Doe.
filter_descriptionstring- Ticket description. Example: refund.
filter_emailstring- Customer email. Example: jane@example.com.
filter_slastring- SLA status. Example: normal.one of
normalwarningurgent filter_ticket_statestring- Ticket state. Example: opened.one of
openedcompleted limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100
simla_user_getGet one Simla user.Read-onlyGet User
Get one Simla user. Returns the user's name, email, phone, groups, status and online state. Use this for a user's details.
Inputs
idintegerrequired- User ID. Example: 1501.
simla_user_groups_listList the Simla user groups.Read-onlyList User Groups
List the Simla user groups. Returns groups with code, name and permissions. Use this to see how staff are organized.
Inputs
limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_users_listList Simla users (managers and staff), filtered by email, activity, online state or status.Read-onlyList Users
List Simla users (managers and staff), filtered by email, activity, online state or status. Returns users with ID, name, email, groups, status and online state. Use limit 20, 50 or 100 and page to move through results.
Inputs
filter_activestring- Active. Example: 0.one of
01 filter_emailstring- User email. Example: jane@example.com.
filter_is_managerstring- User is manager. Example: 1.one of
1 filter_onlinestring- User online. Example: 0.one of
01 filter_statusstring- User status in the system. When using the filter[status] filter, only those users who have the true value in the online field are included in the selection. Example: free.one of
freebusydinnerbreak limitinteger- Quantity of elements in the answer (20 by default). Example: 20.one of
2050100 pageinteger- Number of page with the results (1 by default). Example: 1.
simla_warehouses_listList the warehouses configured in Simla.Read-onlyList Warehouses
List the warehouses configured in Simla. Returns warehouses with code, name, type and address. Use this to get store codes for stock uploads.
Inputs
This tool takes no inputs.
simla_corporate_customer_createCreate a Simla corporate customer (a company account).WriteCreate Corporate Customer
Create a Simla corporate customer (a company account). Returns the new corporate customer's internal ID. Use this for B2B accounts.
Inputs
customerCorporatestringrequired- Corporate customer data as JSON text: nickName, externalId, managerId, tags, customFields, and optionally companies, addresses and customerContacts. Example: {"nickName": "Acme Ltd", "externalId": "corp-55"}
simla_customer_createCreate a Simla customer (individual).WriteCreate Customer
Create a Simla customer (individual). Returns the new customer's internal ID. Use this to add a customer. Use simla_corporate_customer_create for a company.
Inputs
customerstringrequired- Customer data as JSON text: firstName, lastName, email, phones (list of {number}), address, externalId, managerId, tags, customFields and other customer fields from the API reference. Example: {"firstName": "Jane", "lastName": "Doe", "email": "jane@example.com", "phones": [{"number": "+359888123456"}]}
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_customer_note_createAdd a note to a Simla customer.WriteCreate Customer Note
Add a note to a Simla customer. Returns the new note's ID. Use this to log a call or remark about a customer.
Inputs
notestringrequired- Note as JSON text: text and customer ({id} or {externalId}), optionally managerId. Example: {"text": "Prefers delivery after 18:00", "customer": {"id": 2201}}
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_customer_updateEdit a Simla customer by external ID (or internal ID with by=id); only the fields you send change.WriteUpdate Customer
Edit a Simla customer by external ID (or internal ID with by=id); only the fields you send change. Returns the customer's internal ID. Use this to change customer details.
- Idempotent
Inputs
customerstringrequired- Customer data as JSON text: firstName, lastName, email, phones (list of {number}), address, externalId, managerId, tags, customFields and other customer fields from the API reference. Example: {"email": "jane.doe@example.com", "vip": true}
external_idstringrequired- External ID. Example: ext-1001.
bystring- externalId (default) or id: what the externalId path value is. Example: externalId.
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_inventories_uploadUpdate stock balances and purchase prices of Simla offers, up to 250 offers per call.WriteUpload Inventories
Update stock balances and purchase prices of Simla offers, up to 250 offers per call. Returns the number of processed offers and any not found. Use this to sync stock from a warehouse system.
Inputs
offersstringrequired- Offers as JSON text: a list of {externalId or id, stores: [{code, available, purchasePrice}]}. Example: [{"externalId": "sku-77-m", "stores": [{"code": "main-warehouse", "available": 25}]}]
sitestring- Store code; required when offers are identified by externalId. Example: main-store.
simla_order_createCreate a Simla order with customer, items, delivery and payment details.WriteCreate Order
Create a Simla order with customer, items, delivery and payment details. Returns the new order's internal ID and the created order. Use this to register an order from another channel.
Inputs
orderstringrequired- Order data as JSON text: number, externalId, firstName, lastName, phone, email, status, orderMethod, customer ({id} or {externalId}), items (list with offer {externalId} or productName, initialPrice and quantity), delivery and payments, as in the API reference. Example: {"firstName": "Jane", "phone": "+359888123456", "customer": {"id": 2201}, "items": [{"productName": "Hoodie", "initialPrice": 49.9, "quantity": 1}]}
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_order_updateEdit a Simla order by external ID (or internal ID with by=id), such as its status, manager, comments or delivery; only the fields you send change.WriteUpdate Order
Edit a Simla order by external ID (or internal ID with by=id), such as its status, manager, comments or delivery; only the fields you send change. Returns the order's internal ID and the updated order. Use this to move an order through statuses. Use simla_statuses_list for status codes.
- Idempotent
Inputs
external_idstringrequired- External ID. Example: ext-1001.
orderstringrequired- Order fields to change as JSON text, such as status, managerComment, managerId or delivery. Example: {"status": "assembling", "managerComment": "Packed"}
bystring- externalId (default) or id: what the externalId path value is. Example: id.
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_prices_uploadUpdate prices of Simla offers, up to 250 prices per call.WriteUpload Prices
Update prices of Simla offers, up to 250 prices per call. Returns the number of processed prices and any not found. Use this to sync prices from another system.
Inputs
pricesstringrequired- Prices as JSON text: a list of {externalId or id, site, prices: [{code (price type), price}]}. Example: [{"externalId": "sku-77-m", "site": "main-store", "prices": [{"code": "base", "price": 49.9}]}]
simla_task_createCreate a Simla task for a manager, optionally linked to an order or customer.WriteCreate Task
Create a Simla task for a manager, optionally linked to an order or customer. Returns the new task's ID. Use this to schedule a follow-up. Use simla_users_list for performer IDs.
Inputs
taskstringrequired- Task data as JSON text: text (required), commentary, datetime (Y-m-d H:i), performerId (user ID, required), order or customer link, complete (true/false). Example: {"text": "Call the customer about delivery", "performerId": 12, "datetime": "2026-11-18 10:00", "order": {"id": 1501}}
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_task_updateEdit a Simla task, such as its text, due time, performer or completion.WriteUpdate Task
Edit a Simla task, such as its text, due time, performer or completion. Returns the task's ID. Use this to reschedule or complete a task.
- Idempotent
Inputs
idintegerrequired- Task ID. Example: 1501.
taskstringrequired- Task fields to change as JSON text, such as text, datetime, performerId or complete. Example: {"complete": true}
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_ticket_comment_createAdd a comment to a Simla ticket.WriteCreate Ticket Comment
Add a comment to a Simla ticket. Returns the new comment's ID. Use this to log an update on a support case.
Inputs
commentstringrequired- Comment as JSON text: text and ticket ({id} or {externalId} or {number}). Example: {"text": "Refund sent to the card", "ticket": {"id": 42}}
simla_ticket_createCreate a Simla support ticket for a customer.WriteCreate Ticket
Create a Simla support ticket for a customer. Returns the new ticket's ID. Use this to open a support case.
Inputs
ticketstringrequired- Ticket data as JSON text: description, customer ({id} or {externalId}), type, channel, topic, status and other ticket fields from the API reference. Example: {"description": "Package arrived damaged", "customer": {"id": 2201}}
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_ticket_updateEdit a Simla ticket by external ID (or internal ID with by=id); omitted fields keep their values.WriteUpdate Ticket
Edit a Simla ticket by external ID (or internal ID with by=id); omitted fields keep their values. Returns the ticket's ID. Use this to change a ticket's description, topic or status.
- Idempotent
Inputs
external_idstringrequired- External or internal ticket ID. Example: ext-1001.
ticketstringrequired- Ticket fields to change as JSON text, such as description or status. Example: {"description": "Package arrived damaged, refund issued"}
bystring- externalId (default) or id: what the externalId path value is. Example: id.
sitestring- Symbolic code of the store (site) the record belongs to, from simla_sites_list. Example: main-store.
simla_customer_note_deleteDelete a note from a Simla customer.DestructiveDelete Customer Note
Delete a note from a Simla customer. Returns success true. Use this to remove a note.
- Idempotent
Inputs
idintegerrequired- Note ID. Example: 1501.
No tools match.