Skip to content

OnSched Setup API API

by onsched.com

Open documentation ↗

Overview

Build secure and scalable custom apps for onboarding and setup. Our flexible API provides many options for configuration. <br><br> Take the API for a test drive. Just click on the Authorize button below and authenticate. You can access our demo company profile if you are not a customer, or your own profile by using your assigned ClientId and Secret. <br><br> The API has two interfaces, consumer and setup. <ul> <li> The consumer interface provides all the endpoints required for implementing consumer booking flows. </li> <li> The setup interface provides endpoints for profile configuration and setup. </li> </ul> Toggle freely between the two interfaces using the swagger tool bar option labelled 'Select a definition'.

OnSched Setup API is a documents & productivity API from onsched.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 138 endpoints.

At a glance

Authentication
OAuth
HTTPS
Yes
CORS
Unknown
Base URL
https://sandbox-api.onsched.com/
Version
v1
Endpoints
138
Spec updated
2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://sandbox-api.onsched.com/setup/v1/appointments" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://sandbox-api.onsched.com/setup/v1/appointments", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://sandbox-api.onsched.com/setup/v1/appointments",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/setup/v1/appointmentsList Appointments
GET/setup/v1/appointments/{id}Get Appointment
PUT/setup/v1/appointments/{id}/reassign/resource/{resourceId}Reassign Appointment
GET/setup/v1/businessusersList Users
POST/setup/v1/businessusersCreate User
GET/setup/v1/businessusers/permissionsList User Permissions
GET/setup/v1/businessusers/{email}/companiesList User Companies
GET/setup/v1/businessusers/{id}Get User
PUT/setup/v1/businessusers/{id}Update User
DELETE/setup/v1/businessusers/{id}Delete User
GET/setup/v1/calendarsList Calendars
POST/setup/v1/calendarsDEPRECATING: Create
PUT/setup/v1/calendars/block/{id}Update Calendar Block
DELETE/setup/v1/calendars/block/{id}Delete Calendar Block
GET/setup/v1/calendars/blocks/{id}Get Calendar Block
GET/setup/v1/calendars/{id}Get Calendar
PUT/setup/v1/calendars/{id}Update Calendar
DELETE/setup/v1/calendars/{id}Delete Calendar
POST/setup/v1/calendars/{id}/blockCreate Calendar Block
GET/setup/v1/calendars/{id}/blocksList Calendar Blocks
PUT/setup/v1/calendars/{id}/recoverRecover Calendar
GET/setup/v1/calendars/{id}/servicesList Calendar Services
GET/setup/v1/companiesGet Company
POST/setup/v1/companiesCreate Company
PUT/setup/v1/companiesUpdate Company
GET/setup/v1/companies/domainsList Company Domains
POST/setup/v1/companies/domainsCreate Company Domain
GET/setup/v1/companies/domains/{id}Get Company Domain
PUT/setup/v1/companies/domains/{id}Update Company Domain
DELETE/setup/v1/companies/domains/{id}Delete Company Domain
GET/setup/v1/companies/email/templatesList Email Templates
GET/setup/v1/companies/email/templates/masterGet Master Template Settings
POST/setup/v1/companies/email/templates/masterCreate Master Template Settings
DELETE/setup/v1/companies/email/templates/masterDelete Master Template Settings
GET/setup/v1/companies/email/templates/{templateName}Get Email Template
GET/setup/v1/companies/regionsList Regions
POST/setup/v1/companies/regionsCreate Region
GET/setup/v1/companies/regions/{id}Get Region
PUT/setup/v1/companies/regions/{id}Update Region
DELETE/setup/v1/companies/regions/{id}Delete Region
GET/setup/v1/companies/timezones/{date}List Time Zones
GET/setup/v1/customersList Customers
GET/setup/v1/customers/{id}Get Customer
GET/setup/v1/customers/{id}/privacyGet Customer Data
GET/setup/v1/locationsList Locations
POST/setup/v1/locationsCreate Location
POST/setup/v1/locations/bulkCreate Locations Bulk
GET/setup/v1/locations/services/{id}Get Linked Service
DELETE/setup/v1/locations/services/{id}Unlink Service
GET/setup/v1/locations/{id}Get Location
PUT/setup/v1/locations/{id}Update Location
DELETE/setup/v1/locations/{id}Delete Location
GET/setup/v1/locations/{id}/appointmentremindersGet Reminders
PUT/setup/v1/locations/{id}/appointmentremindersUpdate Reminders
DELETE/setup/v1/locations/{id}/deleteallimagesDelete All Location Images
DELETE/setup/v1/locations/{id}/deleteimageDelete Location Image
GET/setup/v1/locations/{id}/email/templatesList Email Templates
POST/setup/v1/locations/{id}/email/templatesCreate Custom Template
GET/setup/v1/locations/{id}/email/templates/masterGet Master Template Settings
POST/setup/v1/locations/{id}/email/templates/masterCreate Master Template Settings
DELETE/setup/v1/locations/{id}/email/templates/masterDelete Master Template Settings
GET/setup/v1/locations/{id}/email/templates/{templateName}Get Email Template
DELETE/setup/v1/locations/{id}/email/templates/{templateName}Delete Custom Template
POST/setup/v1/locations/{id}/google/service/accountCreate Google Cal Access
DELETE/setup/v1/locations/{id}/google/service/accountDelete Google Cal Access
PUT/setup/v1/locations/{id}/holidays/{holidayId}/{closed}Update Location Holidays
PUT/setup/v1/locations/{id}/recoverRecover Location
GET/setup/v1/locations/{id}/servicesList Location Linked Services
POST/setup/v1/locations/{id}/servicesCreate Linked Service
DELETE/setup/v1/locations/{id}/servicesDelete Linked Services
PUT/setup/v1/locations/{id}/settings/scope/{settingsScope}Update Location Scope
POST/setup/v1/locations/{id}/uploadimageUpload Location Image
GET/setup/v1/resourcegroupsList Resource Groups
POST/setup/v1/resourcegroupsCreate Resource Group
GET/setup/v1/resourcegroups/{id}Get Resource Group
PUT/setup/v1/resourcegroups/{id}Update Resource Group
DELETE/setup/v1/resourcegroups/{id}Delete Resource Group
PUT/setup/v1/resourcegroups/{id}/recoverRecover Resource Group
GET/setup/v1/resourcesList Resources
POST/setup/v1/resourcesCreate Resource
GET/setup/v1/resources/allocations/{id}Get Allocation
PUT/setup/v1/resources/allocations/{id}Update Allocation
DELETE/setup/v1/resources/allocations/{id}Delete Allocation
PUT/setup/v1/resources/block/{id}Update Block
DELETE/setup/v1/resources/block/{id}Delete Block
GET/setup/v1/resources/blocks/{id}Get Block
POST/setup/v1/resources/bulkCreate Resources Bulk
PUT/setup/v1/resources/bulkUpdate Resources Bulk
GET/setup/v1/resources/timezonesGet Time Zones
GET/setup/v1/resources/{id}Get Resource
PUT/setup/v1/resources/{id}Update Resource
DELETE/setup/v1/resources/{id}Delete Resource
GET/setup/v1/resources/{id}/allocationsList Resource Allocations
POST/setup/v1/resources/{id}/allocationsCreate Allocation
GET/setup/v1/resources/{id}/availabilityList Weekly Availability
PUT/setup/v1/resources/{id}/availabilityUpdate Weekly Availability
POST/setup/v1/resources/{id}/blockCreate Block
GET/setup/v1/resources/{id}/blocksList Resource Blocks
GET/setup/v1/resources/{id}/calendar/auth/google/{googleEmailAddress}Get Resource Google URL
GET/setup/v1/resources/{id}/calendar/auth/outlook/{outlookEmailAddress}Get Resource Outlook URL

Showing the first 100 of 138 endpoints; the full list is in the documentation.

Questions

Does the OnSched Setup API API need an API key?

Yes. The OnSched Setup API API uses OAuth authentication; the documentation explains how to get credentials.

Does the OnSched Setup API API support HTTPS?

Yes, the OnSched Setup API API is served over HTTPS.

How many endpoints does the OnSched Setup API API have?

Its OpenAPI description lists 138 endpoints in version v1. The first 100 are shown on this page.

What are alternatives to the OnSched Setup API API?

Other Documents & Productivity APIs include JIRA, Notion, DocStruct, Asana, ClickUp.

Compare alternatives →

Listed from APIs.guru (CC0).