> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create workspace

> Create a new workspace in Nedzo via the REST API. Provide a name and optional settings to set up an isolated environment for agents and contacts.

<ParamField body="name" type="string" required>
  Workspace name (1-255 characters)
</ParamField>

<ParamField body="description" type="string">
  Workspace description (max 1000 characters)
</ParamField>

<ParamField body="timezone" type="string">
  IANA timezone identifier (e.g., "America/Los\_Angeles", "Europe/London")
</ParamField>

<ParamField body="icon" type="string">
  Workspace icon URL
</ParamField>

<ParamField body="contactName" type="string">
  Primary contact name
</ParamField>

<ParamField body="contactPhone" type="string">
  Primary contact phone number
</ParamField>

<ParamField body="contactEmail" type="string">
  Primary contact email address
</ParamField>

<ParamField body="streetAddress" type="string">
  Street address
</ParamField>

<ParamField body="state" type="string">
  State or province
</ParamField>

<ParamField body="zip" type="string">
  ZIP or postal code
</ParamField>

<ParamField body="country" type="string">
  Country code or name
</ParamField>

<ParamField body="businessRegistrationNumber" type="string">
  Business registration number (EIN, VAT, etc.)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.nedzo.ai/v1/workspaces" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Acme Corporation",
        "description": "Main workspace for Acme Corp operations",
        "timezone": "America/Los_Angeles",
        "icon": "https://example.com/acme-icon.png",
        "contactName": "Jane Smith",
        "contactPhone": "+1234567890",
        "contactEmail": "jane@acme.com",
        "streetAddress": "123 Main Street",
        "state": "CA",
        "zip": "90210",
        "country": "US",
        "businessRegistrationNumber": "12-3456789"
      }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "accountId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Acme Corporation",
    "description": "Main workspace for Acme Corp operations",
    "timezone": "America/Los_Angeles",
    "icon": "https://example.com/acme-icon.png",
    "contactName": "Jane Smith",
    "contactPhone": "+1234567890",
    "contactEmail": "jane@acme.com",
    "streetAddress": "123 Main Street",
    "state": "CA",
    "zip": "90210",
    "country": "US",
    "businessRegistrationNumber": "12-3456789",
    "balance": 0,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>