Skip to main content
POST
Ask to be told when a Discover provider joins

Headers

Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Body

application/json
service
string
required

The service in two or three words, as a provider would list it, such as dentist or piano lessons. Never the user's own words or personal details.

Required string length: 1 - 80
Example:

"piano lessons"

category
enum<string>
required

The Discover category it belongs to.

Available options:
medical,
barbers,
coaching,
consulting,
lessons,
pets,
sports,
dance,
social,
online-services,
saas,
home-services,
other
Example:

"lessons"

subcategory
string

The subcategory slug within that category, when one fits. A subcategory outside the category is ignored.

Maximum string length: 64
Pattern: ^[a-z0-9-]+$
Example:

"music-and-voice"

searchedArea
string

The searchedArea a search_listings (GET /v2/discover/listings/search) result returned when it found nothing, copied as given; it decides the region the request is matched in, and a repeat returns the open request only from the same region. Leave it out when there was none.

Maximum string length: 120
Example:

"within 10 miles of Seattle, WA"

Response

status
enum<string>
required
Available options:
success,
error
Example:

"success"

data
object
required