# "Workspaces" Endpoints - POST Create a new workspace

**URL:** <https://community.toggl.com/t/workspaces-endpoints-post-create-a-new-workspace/336>\
**Category:** API References\
**Tags:** workspace, api, endpoints, post, create\
**Created:** [December 2, 2024, 12:19pm UTC](https://community.toggl.com/t/workspaces-endpoints-post-create-a-new-workspace/336 "2024-12-02T12:19:06Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [December 2, 2024, 12:19pm UTC](https://community.toggl.com/t/workspaces-endpoints-post-create-a-new-workspace/336/1 "2024-12-02T12:19:06Z")

</div>

```auto
https://api.track.toggl.com/api/v9/organizations/{organization_id}/workspaces

```

Create a workspace within an existing organization.

- cURL
- Go
- Ruby
- JavaScript
- Python
- Rust

```auto
extern crate tokio;extern crate serde_json;use reqwest::{Client};use reqwest::header::{CONTENT_TYPE};#[tokio::main]async fn main() -> Result<(), reqwest::Error> { let client = Client::new().basic_auth("<email>", "<password>"); let json = client.request(Method::POST, "https://api.track.toggl.com/api/v9/organizations/{organization_id}/workspaces".to_string()).json(&serde_json::json!(\{"admins":[\{\}],"default_currency":"string","default_hourly_rate":"number","initial_pricing_plan":"integer","limit_public_project_data":"boolean","name":"string","only_admins_may_create_projects":"boolean","only_admins_may_create_tags":"boolean","only_admins_see_billable_rates":"boolean","only_admins_see_team_dashboard":"boolean","projects_billable_by_default":"boolean","projects_enforce_billable":"boolean","projects_private_by_default":"boolean","rate_change_mode":"string","reports_collapse":"boolean","rounding":"integer","rounding_minutes":"integer"\})) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Parameters[​](https://engineering.toggl.com/docs/api/workspaces/#parameters)

#### Path[​](https://engineering.toggl.com/docs/api/workspaces/#path)

| name | type | required | description |
| --- | --- | --- | --- |
| organization\_id | integer | true | Numeric ID of the organization |

#### Body[​](https://engineering.toggl.com/docs/api/workspaces/#body)

| Name | Type | Description |
| --- | --- | --- |
| admins | Array of integer | List of admins, optional |
| default\_currency | string | Default currency, premium feature, optional, only for existing WS, will be ‘USD’ initially |
| default\_hourly\_rate | number | The default hourly rate, premium feature, optional, only for existing WS, will be 0.0 initially |
| initial\_pricing\_plan | integer | The subscription plan for the workspace, deprecated |
| limit\_public\_project\_data | boolean | Whether the workspace limits public projects data in reports to admins. |
| name | string | Workspace name |
| only\_admins\_may\_create\_projects | boolean | Only admins will be able to create projects, optional, only for existing WS, will be false initially |
| only\_admins\_may\_create\_tags | boolean | Only admins will be able to create tags, optional, only for existing WS, will be false initially |
| only\_admins\_see\_billable\_rates | boolean | Whether only admins will be able to see billable rates, premium feature, optional, only for existing WS. Will be false initially |
| only\_admins\_see\_team\_dashboard | boolean | Only admins will be able to see the team dashboard, optional, only for existing WS, will be false initially |
| projects\_billable\_by\_default | boolean | Whether projects will be set as billable by default, premium feature, optional, only for existing WS. Will be true initially |
| projects\_enforce\_billable | boolean | Whether tracking time to projects will enforce billable setting to be respected. |
| projects\_private\_by\_default | boolean | Whether projects will be set to private by default, optional. Will be true initially. |
| rate\_change\_mode | string | The rate change mode, premium feature, optional, only for existing WS. Can be “start-today”, “override-current”, “override-all” |
| reports\_collapse | boolean | Whether reports should be collapsed by default, optional, only for existing WS, will be true initially |
| rounding | integer | Default rounding, premium feature, optional, only for existing WS |
| rounding\_minutes | integer | Default rounding in minutes, premium feature, optional, only for existing WS |

### Response[​](https://engineering.toggl.com/docs/api/workspaces/#response)

#### 200[​](https://engineering.toggl.com/docs/api/workspaces/#200)

| Name | Type | Description |
| --- | --- | --- |
| admin | boolean | Current user is workspace admin Deprecated |
| api\_token | string | deprecated |
| at | string | Timestamp of last workspace change |
| business\_ws | boolean | Workspace on Premium subscription |
| csv\_upload | object | CSV upload data |
| default\_currency | string | Default currency, premium feature, optional, only for existing WS, will be ‘USD’ initially |
| default\_hourly\_rate | number | The default hourly rate, premium feature, optional, only for existing WS, will be 0.0 initially |
| hide\_start\_end\_times | boolean | - |
| ical\_enabled | boolean | Calendar integration enabled |
| ical\_url | string | URL of calendar |
| id | integer | Identifier of the workspace |
| last\_modified | string | Last modification of data in the workspace |
| limit\_public\_project\_data | boolean | Limit public projects data in reports to admins. |
| logo\_url | string | URL of workspace logo |
| max\_data\_retention\_days | integer | How far back free workspaces can access data. |
| name | string | Name of the workspace |
| only\_admins\_may\_create\_projects | boolean | Only admins will be able to create projects, optional, only for existing WS, will be false initially |
| only\_admins\_may\_create\_tags | boolean | Only admins will be able to create tags, optional, only for existing WS, will be false initially |
| only\_admins\_see\_billable\_rates | boolean | Whether only admins will be able to see billable rates, premium feature, optional, only for existing WS. Will be false initially |
| only\_admins\_see\_team\_dashboard | boolean | Only admins will be able to see the team dashboard, optional, only for existing WS, will be false initially |
| organization\_id | integer | Identifier of the organization |
| permissions | string | Permissions list |
| premium | boolean | Workspace on Starter subscription |
| profile | integer | deprecated |
| projects\_billable\_by\_default | boolean | New projects billable by default |
| projects\_enforce\_billable | boolean | Whether tracking time to projects will enforce billable setting to be respected. |
| projects\_private\_by\_default | boolean | Workspace setting for default project visbility. |
| rate\_last\_updated | string | Timestamp of last workspace rate update |
| reports\_collapse | boolean | Whether reports should be collapsed by default, optional, only for existing WS, will be true initially |
| role | string | Role of the current user in the workspace |
| rounding | integer | Default rounding, premium feature, optional, only for existing WS. 0 - nearest, 1 - round up, -1 - round down |
| rounding\_minutes | integer | Default rounding in minutes, premium feature, optional, only for existing WS |
| subscription | object | deprecated |
| suspended\_at | string | Timestamp of suspension |
| te\_constraints | object | Time entry constraints setting |
| working\_hours\_in\_minutes | integer | Working hours in minutes |

##### csv\_upload[​](https://engineering.toggl.com/docs/api/workspaces/#csv_upload)

| Name | Type | Description |
| --- | --- | --- |
| at | string | - |
| log\_id | integer | - |

##### subscription[​](https://engineering.toggl.com/docs/api/workspaces/#subscription)

| Name | Type | Description |
| --- | --- | --- |
| auto\_renew | boolean | - |
| card\_details | object | - |
| company\_id | integer | - |
| contact\_detail | object | - |
| created\_at | string | - |
| currency | string | - |
| customer\_id | integer | - |
| deleted\_at | string | - |
| last\_pricing\_plan\_id | integer | - |
| organization\_id | integer | - |
| payment\_details | object | - |
| pricing\_plan\_id | integer | - |
| renewal\_at | string | - |
| subscription\_id | integer | - |
| subscription\_period | object | - |
| workspace\_id | integer | - |

##### card\_details[​](https://engineering.toggl.com/docs/api/workspaces/#card_details)

| Name | Type | Description |
| --- | --- | --- |
| added\_at | string | - |
| card\_number | string | - |
| card\_type | string | - |
| creator\_id | integer | - |
| creator\_name | string | - |
| expiry\_date | string | - |
| holder\_name | string | - |

##### contact\_detail[​](https://engineering.toggl.com/docs/api/workspaces/#contact_detail)

| Name | Type | Description |
| --- | --- | --- |
| company\_address | string | - |
| company\_city | string | - |
| company\_name | string | - |
| contact\_detail\_id | integer | - |
| contact\_email | string | - |
| contact\_person | string | - |
| country\_id | integer | - |
| country\_subdivision\_id | integer | - |
| created\_at | string | - |
| customer\_id | integer | - |
| is\_eu\_resident | boolean | - |
| updated\_at | string | - |
| user\_id | integer | - |
| vat\_number | string | - |
| vat\_number\_valid | boolean | DEPRECATED |
| vat\_number\_validated\_at | string | DEPRECATED |
| zip\_code | string | - |

##### payment\_details[​](https://engineering.toggl.com/docs/api/workspaces/#payment_details)

| Name | Type | Description |
| --- | --- | --- |
| created\_at | string | - |
| currency | string | - |
| customer\_id | integer | - |
| payment\_type | string | - |
| reference | string | - |
| user\_id | integer | - |

##### subscription\_period[​](https://engineering.toggl.com/docs/api/workspaces/#subscription_period)

| Name | Type | Description |
| --- | --- | --- |
| created\_at | string | - |
| finished\_on | string | - |
| started\_on | string | - |
| subscription\_id | integer | - |
| subscription\_period\_id | integer | - |
| trial | boolean | - |
| user\_count | integer | - |

##### te\_constraints[​](https://engineering.toggl.com/docs/api/workspaces/#te_constraints)

| Name | Type | Description |
| --- | --- | --- |
| description\_present | boolean | - |
| project\_present | boolean | - |
| tag\_present | boolean | - |
| task\_present | boolean | - |
| time\_entry\_constraints\_enabled | boolean | - |

#### 400[​](https://engineering.toggl.com/docs/api/workspaces/#400)

Possible errors:

- JSON is not valid
- workspace name must contain non-space characters
- workspace name must not be nil
- workspace name must not be longer than 140
- another workspace with same name exists in organization
- user can have a maximum of 100 workspaces
- Multiple workspaces are not enabled in this organization.
- Organization {name} can have a maximum of {amount} workspaces
- User with id {id} does not exist.
- User {userID} not exists in the workspace.

#### 402[​](https://engineering.toggl.com/docs/api/workspaces/#402)

Possible errors:

- Must be a premium user to use default\_hourly\_rate
- restricting tag management to administrators requires a premium subscription
- Must be a premium user to use default\_currency
- Must be a premium user to use rounding\_minutes
- Must be a premium user to use only\_admins\_see\_billable\_rates
- Must be a premium user to use projects\_billable\_by\_default
- Must be a premium user to use rounding

#### 403[​](https://engineering.toggl.com/docs/api/workspaces/#403)

Forbidden

#### 404[​](https://engineering.toggl.com/docs/api/workspaces/#404)

Possible errors:

- Organization not found/accessible
- Workspace not found/accessible
- organization owner not found