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
Update an Address
List all Jobs
Docs powered by archbee