repairshopr-phone

name	repairshopr-phone
description	Manage phone numbers associated with customers in RepairShopr
license	MIT
compatibility	opencode
metadata	{"audience":"receptionists, technicians","api":"GET /customers/{customer_id}/phones, POST /customers/{customer_id}/phones, PUT /customers/{customer_id}/phones/{id}, DELETE /customers/{customer_id}/phones/{id}"}

What I do

I manage phone numbers for customers. Customers can have multiple phone entries (e.g., main line, mobile, fax). I can list, add, update, and delete phone numbers associated with a customer.

When to use me

Use this when:

• A customer has multiple phone numbers you need to track
• Updating or correcting a phone number
• Adding a new contact number during check-in
• Removing an outdated phone number

How to use

Required API base URL:

• VITE_REPAIRSHOPR_SUBDOMAIN
• VITE_REPAIRSHOPR_API_KEY

Permissions: "Customers - View Detail" for reading, "Customers - Edit" for create/update/delete. Single-Customer Users restricted to own data.

List Phones (GET /customers/{customer_id}/phones)

• customer_id (integer, required)

Create Phone (POST /customers/{customer_id}/phones)

• customer_id (integer, required) Body:
• number (string) - Phone number (required but may be optional in API; actually required implicitly)
• label (string, optional) - Label like "Mobile", "Home", "Work"
• extension (string, optional) - Extension number

Update Phone (PUT /customers/{customer_id}/phones/{id})

• customer_id (integer)
• id (integer) - Phone ID Body: number (required), label, extension (optional)

Delete Phone (DELETE /customers/{customer_id}/phones/{id})

• customer_id (integer)
• id (integer) - Phone ID

Example call:

// List customer phones
const phones = await skill({ name: "repairshopr-phone" }, {}, { customer_id: 123, method: 'GET' })

// Add mobile phone
const newPhone = await skill({ name: "repairshopr-phone" }, {
  number: "555-987-6543",
  label: "Mobile"
}, { customer_id: 123, method: 'POST' })

// Update phone number
await skill({ name: "repairshopr-phone" }, {
  number: "555-123-4567"
}, { customer_id: 123, id: newPhone.phone.id, method: 'PUT' })

Response includes:

• List: Array of phone objects with id, label, number, customer_id, extension, created_at, updated_at
• Single: phone object
• Create/Update: phone object
• Delete: success (200)

Important

• The main customer record has primary email and phone fields directly on the customer object; these are separate from the /phones sub-resource
• Use this when you need multiple phone numbers tracked for one customer
• Phone numbers should be formatted consistently (digits, dashes, etc.) but no strict format enforced
• Deleting a phone is permanent

Related skills

• repairshopr-customer-search - To find the customer
• repairshopr-contact - For additional contact people with their own phones