Simla com | Composio Docs

Overview

SLUG: SIMLA_COM

Description

Simla.com is a platform offering API services for integrating delivery services, managing orders, and customer data.

Authentication Details

API Key

subdomain

stringRequired

generic_api_key

stringRequired

Connecting to Simla com

Create an auth config

Use the dashboard to create an auth config for the Simla com toolkit. This allows you to connect multiple Simla com accounts to Composio for agents to use.

Select App

Navigate to [Simla com](https://platform.composio.dev?next_page=/marketplace/Simla com).

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Simla com Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 simla_com_auth_config_id = "ac_YOUR_SIMLA_COM_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Simla com for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, simla_com_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Simla com toolkit’s playground](https://app.composio.dev/app/Simla com)

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["SIMLA_COM"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

SIMLA_COM_CREATE_CUSTOMER

Tool Name: Create Customer

Description

Tool to create a new customer. use after gathering all customer information.

Action Parameters

customer

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_CREATE_CUSTOM_FIELD

Tool Name: Create Custom Field

Description

Tool to create a custom field for a specified entity in simla. use when you need to extend orders, customers, corporate customers, or companies with custom metadata fields.

Action Parameters

code

string

display_area

string

display_in_mobile_app

string

editable

booleanDefaults to True

entity

stringRequired

in_filter

boolean

in_group_actions

boolean

in_list

boolean

name

stringRequired

required

boolean

type

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_CREATE_ORDER

Tool Name: Create Order

Description

Tool to create a new order. use when you have all order details prepared and need to register it in simla via the api.

Action Parameters

order

objectRequired

site

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_CREATE_TASK

Tool Name: Create Task

Description

Tool to create a new task. use after gathering task details and assignees.

Action Parameters

comment

string

customer

object

deadline

string

entity

object

taskType

stringRequired

text

stringRequired

userIds

arrayRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_EDIT_CUSTOMER

Tool Name: Edit Customer

Description

Tool to edit an existing customer. use when you need to update customer details by external id.

Action Parameters

address

object

birthday

string

customFields

object

string

externalId

stringRequired

firstName

string

lastName

string

phone

string

sex

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_EDIT_CUSTOM_FIELD

Tool Name: Edit Custom Field

Description

Tool to edit an existing custom field by entity and code. use when you need to update custom field metadata before usage.

Action Parameters

code

stringRequired

defaultValue

string

description

string

entity

stringRequired

isActive

boolean

isEditable

boolean

isRequired

boolean

isVisible

boolean

name

string

settings

array

sort

integer

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_EDIT_ORDER

Tool Name: Edit Order

Description

Tool to edit an existing order by external id. use when you need to update order details by external id.

Action Parameters

externalId

stringRequired

order

objectRequired

site

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_EDIT_TASK

Tool Name: Edit Task

Description

Tool to edit an existing task. use after confirming task id and fields to update. updates only provided fields on the task.

Action Parameters

stringRequired

task

objectRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_CUSTOMER

Tool Name: Get Customer

Description

Tool to retrieve information about a specific customer. use when you need full customer data by external id before further operations.

Action Parameters

stringDefaults to externalId

externalId

stringRequired

site

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_CUSTOMERS

Tool Name: Get Customers

Description

Tool to retrieve a list of customers. use after setting optional filters (ids, email, custom fields) to fetch paginated customer data.

Action Parameters

filter[customFieldKey]

string

filter[email]

string

filter[ids][]

array

limit

integer

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_CUSTOM_FIELDS

Tool Name: Get Custom Fields

Description

Tool to list custom fields. use when retrieving custom field definitions with optional filtering by entity or code.

Action Parameters

entity

string

filter[code]

string

filter[type]

string

limit

integer

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_ORDER

Tool Name: Get Order

Description

Tool to retrieve detailed information about a specific order. use when you need to fetch full order data by external id before further processing.

Action Parameters

external_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_ORDERS

Tool Name: Get Orders

Description

Tool to retrieve a list of orders. use when you need to fetch orders with optional filters (order numbers, custom fields) and pagination.

Action Parameters

customFields

object

limit

integer

numbers

array

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_PRODUCTS

Tool Name: Get Products

Description

Tool to retrieve a list of products. use when you need to list products with optional filters.

Action Parameters

filter[active]

boolean

filter[createdAtFrom]

string

filter[createdAtTo]

string

filter[externalId]

string

filter[maxPrice]

number

filter[minPrice]

number

filter[name]

string

filter[quantity]

integer

filter[updatedAtFrom]

string

filter[updatedAtTo]

string

ids[]

array

limit

integer

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_SEGMENTS

Tool Name: Get Segments

Description

Tool to retrieve a list of customer segments. use when you need to list segments with optional filters after authentication.

Action Parameters

filter[active]

boolean

filter[createdAtFrom]

string

filter[createdAtTo]

string

filter[name]

string

limit

integer

page

integer

site

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_SITES

Tool Name: Get Sites

Description

Tool to retrieve a list of sites. use when you need to discover all configured sites with optional pagination.

Action Parameters

limit

integer

page

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_TASK

Tool Name: Get Task

Description

Tool to retrieve detailed information about a specific task. use when you need full task details by task id before taking further actions.

Action Parameters

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_TASKS

Tool Name: Get Tasks

Description

Tool to retrieve a list of tasks with optional filters. use when you need to fetch tasks after specifying filter criteria like ids, status, or date range.

Action Parameters

createdAtFrom

string

createdAtTo

string

expand

array

filter

array

ids

array

limit

integer

offset

integer

orderIds

array

responsibleUserIds

array

status

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

SIMLA_COM_GET_USERS

Tool Name: Get Users

Description

Tool to retrieve a list of users. use when you need to fetch users with optional pagination, filtering, and sorting.

Action Parameters

filter[createdAtFrom]

string

filter[createdAtTo]

string

filter[customField]

string

filter[externalId]

string

limit

integer

page

integer

sortBy

string

sortOrder

string

Action Response

data

objectRequired

error

string

successful

booleanRequired