1
Add Your First Customer
Main nav → Customers- Click the menu and select Customers
- Click the blue New customer button (top right)
- Enter the customer's display name (required) — e.g., Jane Homeowner or Acme Corp
- Optionally enter the company name, email, and phone
- Add any notes (e.g., 'prefers morning appointments', 'ask about payment terms')
- Click Create customer
What to enter
- Display name (required): The name you'll see in your customer list. Can be a person or business.
- Company (optional): The organization name if different from display name.
- Email (optional): Needed if you want to send them estimates, invoices, or portal access.
- Phone (optional): Displayed in the customer list; used for job scheduling and outreach.
- Notes (optional): Internal reminders for your team (not shared with the customer).
Tips
- You can search customers by name, email, or phone from the Customers page — names are case-insensitive.
- Email is optional now but required later if you want to send the customer a self-serve portal link.
- Phone format is not enforced—enter it however your team uses it (555-123-4567, (555) 123-4567, etc.).
Watch out
- Display name is the only required field. If you leave it blank, the system creates one automatically.
- Once a customer is created, you can edit their details by clicking their name in the Customers list.
2
Add a Property to the Customer
Customer detail page → Properties section (bottom half)- From the Customers page, click the customer's name to open their detail view
- Scroll to the Properties section near the bottom
- Enter a property label in the 'New property label' field (e.g., 'Main residence' or 'Office building')
- Start typing the street address in the Address field — smart suggestions appear after 3 characters
- Click a suggested address to auto-fill the full address (street, city, state, postal code)
- Or manually type the address fields if autocomplete suggestions don't match
- Optionally enter a gate code or access instructions
- Click Add property
What to enter
- Property label (optional): A friendly name to distinguish multiple properties for the same customer.
- Address (autocomplete): Start typing the street address. The system pulls real Canadian addresses from the address database. Works best with full street names.
- City, State/Province, Postal code: Auto-populated when you select from suggestions, or enter manually.
- Gate code (optional): Access codes, buzzer numbers, or parking instructions technicians need on arrival.
Tips
- Address autocomplete requires at least 3 characters in the street field and debounces queries to stay responsive.
- If the autocomplete doesn't find your address, you can type it manually in each field—it doesn't have to match a suggestion.
- Multiple properties let you organize equipment and schedule jobs separately (e.g., customer has a main office and a warehouse).
- You can add properties anytime from this page; the customer detail page always shows the add-property form at the bottom.
Watch out
- The address autocomplete is powered by external geocoding and requires the system to be configured (if it's not working, fall back to manual entry).
- Property names are optional but helpful when a customer has many locations. Leaving it blank shows 'Property' in the list.
- Addresses are stored as structured data (line1, city, state, postalCode). Anything in line1 is treated as the street address.
3
Add Equipment to a Property
Customer detail page → Properties section → within each property card- On the customer's detail page, locate the property where you want to add equipment
- Scroll down to the bottom of that property's card
- In the 'Add equipment' form (below the equipment list), enter the equipment type (e.g., 'AC Condenser', 'Furnace', 'Water Heater')
- Optionally enter the make, model, and serial number
- Click the Add button to save the equipment record
What to enter
- Type (required): What kind of equipment. Examples: AC Condenser, Furnace, Water Heater, Electrical Panel.
- Make (optional): The manufacturer name (e.g., 'Carrier', 'Trane', 'Navien').
- Model (optional): The model number or name from the manufacturer.
- Serial (optional): The serial number from the equipment nameplate. Essential for warranty and service history tracking.
Tips
- Equipment entries appear in a list under the property name. Click New job here to create a work order for that property and see all its equipment in the job form.
- Equipment records are scoped to properties, so the same equipment type (e.g., 'Furnace') under different properties stays separate.
- You can add multiple pieces of equipment to one property and see them all listed together—helpful for customers with multiple units.
- Serial numbers are not validated (you can paste them exactly as they appear on the nameplate).
Watch out
- Type is required; leaving it blank won't add equipment. If you don't know the exact type yet, use a generic name like 'HVAC' and refine it later.
- You can only add equipment from this view on the customer's detail page. You cannot edit or delete equipment once added from this interface.
- Equipment is displayed with the format 'Type — Make Model (S/N Serial)'. Missing fields simply don't display.
4
Use Customer Addresses When Creating Jobs
Customer detail page → New job button OR Jobs page → New job- Click the New job button on the customer's detail page (or go to Jobs > New job from the main nav)
- The customer is pre-selected (if you came from their detail page)
- Select the property where the work will happen — all addresses you added appear in the list
- All equipment in that property auto-loads in the job form (optional, but helpful for reference)
- Complete the job form (title, description, priority, assigned technician, etc.) and save
Tips
- Properties and equipment are read-only shortcuts in job creation—they're populated from the customer record you set up earlier.
- When you assign a technician to a job, they'll see the customer's property address and equipment list on their mobile app.
Watch out
- You must have at least one property for a customer before you can create a job for them. The property dropdown will be empty if you skip this step.
5
Enable Customer Portal Access (Optional)
Customer detail page → Customer portal card (top)- On the customer's detail page, find the 'Customer portal' card (below contact info)
- Click Enable portal link
- The system generates a unique, secure link like /portal/{token}
- Share this link with the customer (email, SMS, etc.). They can then view their jobs, estimates, and invoices online
Tips
- The portal is a self-serve page where customers approve estimates, pay invoices, and track job status without logging in.
- Portal links are unique per customer—you can safely share them without creating an account for the customer.
- Customers never see your internal notes, pricing markup, or team discussions.
Watch out
- Portal links are only generated on demand. No link is created until you click Enable portal link.
6
Search and Export Customers
Customers page- Go to Customers from the main nav
- Use the search box to find customers by name, email, or phone. The search is live and case-insensitive.
- To export all customers to a CSV file, click the Export CSV button (top right)
Tips
- CSV exports include name, company, email, phone, and account balance—useful for importing into spreadsheets or mailing lists.
- Search filters are applied instantly; no need to click a search button.
- The system shows up to 200 customers per view. If you have more, use search to narrow down.
Watch out
- Export includes all customers in your account, regardless of any filters you're viewing. Search filters do not affect the export.
7
Understand Account Balances
Customers page → Balance column OR Customer detail page → Balance card- Open the Customers page or a customer's detail page
- The Balance field shows the customer's current account balance (positive or negative)
- Positive = customer owes you money; Negative = they've overpaid or you owe them a refund
Tips
- Balances are calculated automatically from invoices and payments. You don't need to manually adjust them unless recording cash payments.
- Use the balance to quickly spot customers with outstanding invoices or prepayments.
Watch out
- Balances are in cents in the database but display as dollars with two decimal places ($XX.XX).
Done when
- Create at least one customer with display name, optional email & phone
- Add a property address to that customer using the address autocomplete
- Add at least one equipment item (type required; make, model, serial optional)
- Create a test job on that property and confirm equipment appears in the form
- Optionally enable the customer portal link and share it with the customer
- Verify customer, property, and equipment appear correctly on the customer detail page
Need a hand? Talk to a specialist or start your free trial.