Create Workspace
Table of Contents
Purpose
To create a new workspace
Request URL
https://www.zohoapis.com/bookings/v1/json/createworkspace
Headers
| Parameter Name | Description |
|---|---|
| Authorization | Zoho-oauthtoken {{accesstoken}} |
Note: The access token can be generated from the developer console.
Request Method
POST
Parameters
Parameters to be passed in the request body as form-data along with the request URL are,
| Parameter Name | Description |
|---|---|
| name* | The name of the workspace to be created |
Response Type
JSON
Points to consider
Special Characters
- Special characters like |/\\,?{}<>:;\"'`\ are not supported in the workspace name.
Workspace name length
- The length of the workspace name must be between 2 - 50 characters.
Unable to create workspace
- If you get the above error message, it could be due to two reasons:
- When there is no active workspace in the account. Please create a workspace by logging in to Bookings.
- When the number of workspaces allowed for the account has exceeded. Please upgrade your existing plan or delete any unused workspace.
API Limits
| Zoho Bookings Plan/Edition | Number of API calls/day |
| Free | 250/per user |
| Basic | 1000/per user |
| Premium | 3000/per user |
| Zoho One | 3000/per user |
Note: The API limits are excluding the authorization requests. API counts are calculated between 00:00 and 23:59 hours in the respective time zones.
Related Links
Sample Request
Copied{
"name" : "Consultations - New York"
}Sample Response
Copied{
response : {
"returnvalue" : {
"message" : "Workspace created successfully.",
"status" : "success"
},
"status" : "success"
}
}