website logo
⌘K
Getting Started
What is TIDY?
Getting Started: Rental Properties
Getting Started: Employer Benefits
Getting Started: Residential Homes
Getting Started: Offices
Dashboard
TIDY AI
Acceptance Probability
Teams & Users
Users
Teams
Properties/Addresses
Access Instructions
Jobs
Add or Request a Job
View, Edit, or Cancel Jobs
Setting Backup Times
Job Links
Job Reviews or Feedback
Resolving Pro Cancellations
Account Settings
Messages
Notifications
Plans
Access Control / Smartlocks
My Pros
Booking Different Type Of Services With Your Pros
Private Cleaning Payment
Defining your Job Request Strategy
To-Do Lists
Video Introductions
To-Do List Links
To-Dos
Do-Nots
Remote Inspections
Custom Fields
Laundry or Linens
Supply Preferences
Integrations
Automatic Booking
Billing, Pricing, & Payments
Billing History
Sending Payments
Bills & Payment Methods
Team Billing
View & Edit Prices
Viewing Billing History
Tips
Refunds
Rebate Program
Tax Reporting for Payments to Pros
Compliance, Ratings, Safety, Insurance, & Protection
Insurance or Custom Requirements
Certifications & Ratings
Satisfaction Guarantee, Disputes, & Protection
Damage Claims
Property Maps
Maintenance
Inventory Tracking
Inspections
Smart Thermostats
Issue Tracking
Automatic Translation
Other Questions
TIDY Concierge
Reports
Accounting
Developers
API Introduction
Authentication
Changelog
Errors
API Reference
Webhooks
Best Practices
Docs powered by archbee 

Create a Pro

2min
POST

Adds a Pro to the Priority List for all addresses in a customer account.

Useful if you want to sync Pro information from another application into TIDY.

Once a Pro is added, you can modify their priority on your list (online not via the API at this time) and request Jobs from them.

For more information on pros, view our docs: https://help.tidy.com/my-pros

AUTHENTICATION
Authorization
string
Bearer
BODY PARAMETERS
body
object
name
string
*
Name of Pro (e.g. "John Smith")
email
string
*
Email of Pro (e.g. "john@smith.com")
phone
string
A valid phone number includes a "+", then the country code, then the number. Ex. A US number of (222) 333-5555 should be sent as +12223335555
service_types
string[]
All service types that apply to this Pro
RESPONSES
201
Created
Pro
# About Pros A Pro is a Service Provider. Adding Pros allows you to request them in Jobs. When adding a Pro, by default they are added to your Approved Pros list for the Service Types you specify. A Pro can do one or more Service Types. Typically, people want to add more Pros to to their approved list to improve the likelihood of getting someone to an appointment (even if they like another Pro better). If you prefer one Pro over another, adjust their Request Order online at tidy.com. For example: If you add 'Super Cleaning Service' as a Pro for service type 'regular_cleaning'. When you request a Job of type 'regular_cleaning', they will be included in your request as a 'approved' vendor. If you like 'Super Cleaning Service' the best, you would increase its order by logging into your account at tidy.com. # More details about a Job | Attribute | Description | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | name | The name of the Pro | | email | The email of the Pro | | phone | The phone of the Pro. Format with country code (US is "+1") like `+11231234567` | | service_type | Service Type is a list of services the Pro is able to be booked for.
**regular_cleaning** - The `Pro` is eligible to be booked for `Jobs` with a `service_type` of `regular_cleaning` | created_at | Date and time of when the `Pro` was created. UTC and ISO formatted | |
object
string<pro>
*
id
integer
*
name
string
*
Pro Name
email
string
*
Pro Email
phone
string
*
Pro Phone
service_types
string[]
*
All service types that apply to this Pro
created_at
string
*
Date and time of when the `Pro` was created. UTC and ISO formatted




Updated 26 Apr 2023
Did this page help you?
Yes
No
PREVIOUS
Update an Address
NEXT
List all Jobs
Docs powered by archbee