Create organization

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://restapi.wyzio.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}

POST /api-v1/organization

Creates a new organization based on another organization or template. Returns 200 on success, or 400 if the creation is not valid.

Headers

WEAL-TOKEN Required

API token (can be retrieved from account settings)
TARGET-ORGANIZATION-ID

ID of organization, for which the operation must be performed

application/json

Body Required

name string Required

Organization name
mainLanguage object Required

Main language of the organization
Hide mainLanguage attributes Show mainLanguage attributes object
- id integer(int64)
- code string
- name string
- isMain boolean
currency string Required

ISO 4217 currency code
templateCompanyBy string Required

How to determine the template organization

Values are NOGA_CODE or TEMPLATE_ORGANIZATION.
nogaCodeId integer

NOGA economic activity code ID. Required when templateCompanyBy = NOGA_CODE
templateOrganizationId integer

Template organization ID. Required when templateCompanyBy = TEMPLATE_ORGANIZATION
startDate string Required

Start date (format dd/MM/yyyy)
address object

Primary address for the organization
Hide address attributes Show address attributes object
- id integer(int64)
- name string
- line1 string Required
  
  Minimum length is 1.
- line2 string
- city string Required
  
  Minimum length is 1.
- region object
  Hide region attributes Show region attributes object
  
  id integer(int64)
  
  name string
  
  code string
  
  taxMode string
  
  Values are ANNUALLY or MONTHLY.
- countryCode2 string Required
  
  Minimum length is 1.
- postCode string Required
  
  Minimum length is 1.
- toTheAttentionOf string
- position integer(int32)
- countryId integer(int64)
- houseNumber string
- service string
- dtbNumber string
- cedNumber string
- fiduciaryId integer(int64)
- inventoryLocation boolean
fiscalYearStart string Required

Fiscal year start date (format dd/MM/yyyy)
fiscalYearEnd string Required

Fiscal year end date (format dd/MM/yyyy)
vatRuleType string Required

VAT rule type

Values are NONE, AGREED_SERVICE, RECEIVED_COMPENSATION, NTDR_AGREED_SERVICE, NTDR_RECEIVED_COMPENSATION, FLAT_RATE_RECEIVED_COMPENSATION, FLAT_RATE_AGREED_SERVICE, or SIMPLE_TAX_RATE.
timesheets boolean

Whether timesheets are enabled for this organization
managingCompanyId integer Required

Managing company (fiduciary) organization ID

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- error object
  
  Hide error attributes Show error attributes object
  
  errorCode string
  
  Values are NO_ERROR, NOT_IMPLEMENTED_YET, CONTACT_NOT_FOUND, FIELD_REQUIRED, VALIDATION_ERROR, DUPLICATION_ERROR, UNIQUE_CONSTRAINT_VIOLATION, WRONG_PASSWORD_FORMAT, WRONG_PASSWORD, ACTION_DENIED, NOT_FOUND, EXPECTED_ONE_FILE, UNIQUE_VIOLATION, CONTENT_EMPTY, INVALID_TYPE, CONVERSION_ERROR, FILE_PARSE_EXCEPTION, or IN_USE.
  
  errorDetailValues array[object]
  
  Hide errorDetailValues attributes Show errorDetailValues attributes object
  
  errorCode string
  
  fieldName string
  
  data string
  
  isSevere boolean
- valid boolean
400

400 Bad Request
401

401 Unauthorized
403

403 Access Denied
404

404 Not Found
500

500 Internal Server Error

POST /api-v1/organization

curl \
 --request POST 'https://wyzio.app/api-v1/organization' \
 --header "Content-Type: application/json" \
 --data '[{"name":"Acme Corp","mainLanguage":{"id":42,"code":"string","name":"string","isMain":true},"currency":"CHF","templateCompanyBy":"NOGA_CODE","nogaCodeId":12345678,"templateOrganizationId":12345678,"startDate":"01/01/2026","address":{"id":42,"name":"string","line1":"string","line2":"string","city":"string","region":{"id":42,"name":"string","code":"string","taxMode":"ANNUALLY"},"countryCode2":"string","postCode":"string","toTheAttentionOf":"string","position":42,"countryId":42,"houseNumber":"string","service":"string","dtbNumber":"string","cedNumber":"string","fiduciaryId":42,"inventoryLocation":true},"fiscalYearStart":"01/01/2026","fiscalYearEnd":"31/12/2026","vatRuleType":"EFFECTIVE","timesheets":false,"managingCompanyId":12345678}]'

Request examples

# Headers

# Payload
[
  {
    "name": "Acme Corp",
    "mainLanguage": {
      "id": 42,
      "code": "string",
      "name": "string",
      "isMain": true
    },
    "currency": "CHF",
    "templateCompanyBy": "NOGA_CODE",
    "nogaCodeId": 12345678,
    "templateOrganizationId": 12345678,
    "startDate": "01/01/2026",
    "address": {
      "id": 42,
      "name": "string",
      "line1": "string",
      "line2": "string",
      "city": "string",
      "region": {
        "id": 42,
        "name": "string",
        "code": "string",
        "taxMode": "ANNUALLY"
      },
      "countryCode2": "string",
      "postCode": "string",
      "toTheAttentionOf": "string",
      "position": 42,
      "countryId": 42,
      "houseNumber": "string",
      "service": "string",
      "dtbNumber": "string",
      "cedNumber": "string",
      "fiduciaryId": 42,
      "inventoryLocation": true
    },
    "fiscalYearStart": "01/01/2026",
    "fiscalYearEnd": "31/12/2026",
    "vatRuleType": "EFFECTIVE",
    "timesheets": false,
    "managingCompanyId": 12345678
  }
]

Response examples (200)

{
  "error": {
    "errorCode": "NO_ERROR",
    "errorDetailValues": [
      {
        "errorCode": "string",
        "fieldName": "string",
        "data": "string",
        "isSevere": true
      }
    ]
  },
  "valid": true
}