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 |
Related Links
Sample Request
Copied{
"name" : "Consultations - New York"
}
Sample Response
Copied{
response : {
"returnvalue" : {
"message" : "Workspace created successfully.",
"status" : "success"
},
"status" : "success"
}
}