Repairshopr

Learn how to use Repairshopr with Composio

Overview

SLUG: REPAIRSHOPR

Description

RepairShopr is a comprehensive repair shop management software designed to streamline operations, manage customer relationships, and enhance business efficiency.

Authentication Details

subdomain
stringRequired
generic_api_key
stringRequired

Connecting to Repairshopr

Create an auth config

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

1

Select App

Navigate to the Repairshopr toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

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

3

Create and Get auth config ID

Click “Create Integration”. 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

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

Tools

Executing tools

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["REPAIRSHOPR"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def 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
33invoke_llm()

Tool List

Tool Name: Delete Appointment

Description

Tool to delete a specific appointment by its id. use when an appointment is canceled and needs removal permanently.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Customer

Description

Tool to delete a specific customer by id. use after confirming the customer id when you need to remove a customer record permanently.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Estimate

Description

Tool to delete a specific estimate by id. use when you need to remove an estimate record permanently.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Invoice

Description

Tool to delete a specific invoice by id. use when you need to remove an invoice permanently after confirming it's no longer needed. ensure no dependent records require it before running.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Appointment

Description

Tool to retrieve details of a specific appointment by its id. use when you need exact details of an appointment by id.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Appointments

Description

Tool to retrieve a list of appointments. use when listing appointments by date range or for current user. returns up to 25 results per page.

Action Parameters

date_from
string
date_to
string
mine
boolean
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Asset

Description

Tool to retrieve details of a specific asset by its id. use when you need to confirm asset details after obtaining its id. requires assets - view details permission.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Assets

Description

Tool to retrieve a paginated list of assets. use when you need to list or search assets by snmp status, customer, asset type, or query after authenticating. returns 25 items per page.

Action Parameters

asset_type_id
integer
customer_id
integer
page
integer
query
string
snmp_enabled
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Case Attachments

Description

Tool to retrieve attachments for a specific service case. use when you need to list all files attached to a case.

Action Parameters

case_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Contacts

Description

Tool to retrieve a paginated list of contacts. use when you need to fetch contacts optionally filtered by customer. returns up to 25 contacts per page.

Action Parameters

customer_id
integer
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Customer

Description

Tool to retrieve details of a specific customer by id. use after confirming the customer exists. example: "get customer details for id 123".

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Customers

Description

Tool to retrieve a list of customers. use when you need to search or filter customers with pagination. returns up to 25 results per page.

Action Parameters

business_name
string
email
string
firstname
string
id
array
include_disabled
boolean
lastname
string
not_id
array
page
integer
query
string
sort
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Employee Time Clock

Description

Tool to retrieve the last time clock entry for a specific user. use when needing the most recent clock-in/out. example: "get the latest time clock entry for user 5".

Action Parameters

user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Estimate

Description

Tool to retrieve details of a specific estimate by id. use when you need exact details of an estimate by id.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Estimates

Description

Tool to retrieve a list of estimates. use when you need to list or filter estimates by customer or paginate results after authentication.

Action Parameters

customer_id
integer
page
integer
per_page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Invoice

Description

Tool to retrieve details of a specific invoice by id. use after confirming the invoice exists. example: "get invoice details for id 456".

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Invoices

Description

Tool to retrieve a paginated list of invoices. use when you need to list invoices, optionally filtered by payment status, ticket association, or update date. returns up to 25 invoices per page.

Action Parameters

page
integer
paid
boolean
since_updated_at
string
ticket_id
integer
unpaid
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Lead

Description

Tool to retrieve details of a specific lead by its id. use when you need to inspect a single lead after obtaining its id. example: "get lead details for id 123".

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Leads

Description

Tool to retrieve a paginated list of leads. use when you need to browse or filter potential customers. returns up to 25 leads per page.

Action Parameters

page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Payment

Description

Tool to retrieve details of a specific payment by id. use after obtaining the payment id. example: "get payment details for id 123".

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Payments

Description

Tool to retrieve a paginated list of payments. use when you need to view or search payment records, with optional filtering by query or pagination.

Action Parameters

page
integer
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Product

Description

Tool to retrieve details of a specific product by id. use after confirming the product id exists. example: "get product details for id 123".

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Products

Description

Tool to retrieve a list of products. use when you need to search or filter products by various criteria. returns up to 25 results per page.

Action Parameters

category_id
integer
id
array
id_not
array
name
string
page
integer
query
string
sku
string
sort
string
upc_code
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Products By Category

Description

Tool to retrieve products filtered by category id. use when you need to list all products in a specific category.

Action Parameters

category_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Product Categories

Description

Tool to retrieve product categories. use when you need to fetch all categories for product organization and filtering.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Product Serials

Description

Tool to retrieve all serial numbers for a specific product. use when you need to list serials by product id after confirming the product exists.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Ticket

Description

Tool to retrieve details of a specific ticket by its id. use when you need full ticket information after obtaining its id.

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get User

Description

Tool to retrieve details of a specific user by id. use after confirming the user exists. example: "get user details for id 42".

Action Parameters

id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Users

Description

Tool to retrieve a list of all users. use when you need to list all users in the system to map ids to names.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Appointment

Description

Tool to create a new appointment. use after gathering summary and date range.

Action Parameters

all_day
boolean
appointment_duration
string
appointment_type_id
integer
customer_id
integer
description
string
do_not_email
boolean
email_customer
boolean
end_at
stringRequired
location
string
start_at
stringRequired
summary
stringRequired
ticket_id
integer
user_id
integer
user_ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Asset

Description

Tool to create a new asset. use when you need to register a device under a customer with either an existing or new asset type.

Action Parameters

asset_serial
string
asset_type_id
integer
asset_type_name
string
customer_id
integerRequired
name
stringRequired
properties
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Customer

Description

Tool to create a new customer. use when you need to add a customer record with contact details.

Action Parameters

address
string
address2
string
business_name
string
city
string
email
string
firstname
string
lastname
string
mobile
string
phone
string
state
string
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Estimate

Description

Tool to create a new estimate. use when you have final customer details and line items ready to generate an estimate in repairshopr.

Action Parameters

created_at
string
customer_id
integerRequired
date
stringRequired
line_items
array
location_id
integer
name
string
note
string
number
string
status
string
ticket_id
integer
updated_at
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Invoice

Description

Tool to create a new invoice. use when you need to bill a customer after gathering customer id, date, and optional line items.

Action Parameters

contact_id
integer
customer_id
integerRequired
date
stringRequired
due_date
stringRequired
hardwarecost
number
line_items
array
location_id
integer
note
string
number
string
po_number
string
ticket_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Lead

Description

Tool to create a new lead. use when you need to add a potential customer to the system.

Action Parameters

address
string
business_name
string
city
string
converted
boolean
email
string
first_name
string
last_name
string
mobile
string
phone
string
state
string
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Payment

Description

Tool to create a new payment. use when you need to record a payment against an invoice in repairshopr.

Action Parameters

address_city
string
address_street
string
address_zip
string
amount_cents
integerRequired
apply_payments
object
credit_card_number
string
customer_id
integer
cvv
string
date_month
string
date_year
string
firstname
string
invoice_id
integer
invoice_number
string
lastname
string
payment_method
string
ref_num
string
register_id
integer
signature_data
string
signature_date
string
signature_name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Product

Description

Tool to create a new product in inventory. use when you need to add an item with price and details to your repairshopr catalog.

Action Parameters

active
boolean
category_id
integer
cost
number
description
string
manufacturer
string
model_number
string
name
stringRequired
photo
string
price
numberRequired
quantity
integer
serialized
boolean
sku
string
taxable
boolean
upc_code
string
vendor_ids
array
weight
number

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add Product Photo

Description

Tool to add photo(s) to a specific product. use when you need to attach one or more images to a product after confirming the product id.

Action Parameters

files
arrayRequired
id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired