> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Team
> Create a new Team record.
## Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
The authenticated user must be a full unrestricted administrator or have the **`Team-Create`** role.
## Request Body
### Required Fields
Business Id.
Team name.
### Optional Fields
Team description.
Tunnel private group ID.
Team Members.
Team Administrators.
Create a single invoice for the team.
Use special prices.
Paying Member Id.
Default Member Tariff Id.
Maximum team member count.
Transfer credits to paying member.
Share time passes.
Share extra services.
Share booking credit.
Discount for extra services.
Discount for time passes.
Discount for charges.
Discount for tariffs.
Profile summary.
Profile tags.
Profile website.
Google Maps link.
Whether the profile is public.
Whether the team has a community group.
New Team Logo Url.
Clear Team Logo File.
New Team Image1Url.
Clear Team Image1File.
New Team Image2Url.
Clear Team Image2File.
New Team Image3Url.
Clear Team Image3File.
Twitter handle.
Facebook URL.
LinkedIn URL.
Skype handle.
Telegram handle.
GitHub URL.
Pinterest URL.
Flickr URL.
Instagram URL.
Vimeo URL.
Tumblr URL.
Blogger URL.
Disable attendance dashboard.
Extra Services.
## Code Examples
```bash cURL theme={null}
curl -X POST \
"https://spaces.nexudus.com/api/spaces/teams" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"BusinessId": 0,
"Name": ""
}'
```
```javascript JavaScript theme={null}
const response = await fetch(
'https://spaces.nexudus.com/api/spaces/teams',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
BusinessId: 0,
Name: ''
})
}
);
const data = await response.json();
```
```python Python theme={null}
import requests
response = requests.post(
'https://spaces.nexudus.com/api/spaces/teams',
headers={
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
json={
'BusinessId': 0,
'Name': ''
}
)
data = response.json()
```
## Response
### 200
HTTP status code. `200` on success.
A human-readable message confirming the creation.
Contains the `Id` of the newly created record.
`true` if the team was created successfully.
`null` on success.
```json Example Response theme={null}
{
"Status": 200,
"Message": "Team was successfully created.",
"Value": {
"Id": 87654321
},
"OpenInDialog": false,
"OpenInWindow": false,
"RedirectURL": null,
"JavaScript": null,
"UpdatedOn": "2025-01-15T10:30:00Z",
"UpdatedBy": "admin@example.com",
"Errors": null,
"WasSuccessful": true
}
```
### 400
A summary of the validation error(s), in the format `PropertyName: error message`.
`null` on validation failure.
Array of validation errors.
The value that was submitted for the field, or `null` if missing.
The validation error message.
The name of the property that failed validation.
`false` when the request fails validation.
```json Example Response theme={null}
{
"Message": "Name: is a required field",
"Value": null,
"Errors": [
{
"AttemptedValue": null,
"Message": "is a required field",
"PropertyName": "Name"
}
],
"WasSuccessful": false
}
```