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 Repairshopr.

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 Repairshopr 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

1from composio import Composio
2
3# Replace these with your actual values
4repairshopr_auth_config_id = "ac_YOUR_REPAIRSHOPR_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def 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 Repairshopr for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, repairshopr_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Repairshopr toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

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
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
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
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
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
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
date_to
mine
page

Action Response

data
objectRequired
error
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
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
customer_id
page
query
snmp_enabled

Action Response

data
objectRequired
error
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
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
page

Action Response

data
objectRequired
error
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
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
email
firstname
id
include_disabled
lastname
not_id
page
query
sort

Action Response

data
objectRequired
error
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

Action Response

data
objectRequired
error
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
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
page
per_page

Action Response

data
objectRequired
error
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
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
paid
since_updated_at
ticket_id
unpaid

Action Response

data
objectRequired
error
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
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

Action Response

data
objectRequired
error
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
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
query

Action Response

data
objectRequired
error
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
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
id
id_not
name
page
query
sku
sort
upc_code

Action Response

data
objectRequired
error
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
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
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
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
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
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
successful
booleanRequired

Tool Name: Create Appointment

Description

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

Action Parameters

all_day
appointment_duration
appointment_type_id
customer_id
description
do_not_email
email_customer
end_at
stringRequired
location
start_at
stringRequired
summary
stringRequired
ticket_id
user_id
user_ids

Action Response

data
objectRequired
error
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
asset_type_id
asset_type_name
customer_id
integerRequired
name
stringRequired
properties

Action Response

data
objectRequired
error
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
address2
business_name
city
email
firstname
lastname
mobile
phone
state
zip

Action Response

data
objectRequired
error
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
customer_id
integerRequired
date
stringRequired
line_items
location_id
name
note
number
status
ticket_id
updated_at

Action Response

data
objectRequired
error
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
customer_id
integerRequired
date
stringRequired
due_date
stringRequired
hardwarecost
line_items
location_id
note
number
po_number
ticket_id

Action Response

data
objectRequired
error
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
business_name
city
converted
email
first_name
last_name
mobile
phone
state
zip

Action Response

data
objectRequired
error
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
address_street
address_zip
amount_cents
integerRequired
apply_payments
credit_card_number
customer_id
cvv
date_month
date_year
firstname
invoice_id
invoice_number
lastname
payment_method
ref_num
register_id
signature_data
signature_date
signature_name

Action Response

data
objectRequired
error
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
category_id
cost
description
manufacturer
model_number
name
stringRequired
photo
price
numberRequired
quantity
serialized
sku
taxable
upc_code
vendor_ids
weight

Action Response

data
objectRequired
error
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
successful
booleanRequired