Create Workspace

Table of Contents

 

Purpose

To create a new workspace

 

Request URL

https://www.zohoapis.com/bookings/v1/json/createworkspace

 

Headers

Parameter NameDescription
AuthorizationZoho-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 NameDescription
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/EditionNumber of API calls/day
Free250/per user
Basic1000/per user
Premium3000/per user
Zoho One3000/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"
	}
}