> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Create Company

- Component: `appmixer.superoffice.core.CreateCompany`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.superoffice 1.2.0](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateCompany>

Create a company (a contact in SuperOffice). The company starts from the defaults SuperOffice sets for new companies.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Name (`name`) | text | The company name. |
| Department (`department`) | text | The department of the company. |
| Organization Number (`orgNr`) | text | The organization (VAT) number. |
| Category (`categoryId`) | text | Pick a category, or type its ID. |
| Business (`businessId`) | text | Pick a business, or type its ID. |
| Country (`countryId`) | text | Pick a country, or type its ID. |
| Email (`email`) | text | Email address of the company. |
| Phone (`phone`) | text | Phone number of the company. |
| Website (`website`) | text | Website of the company, e.g. https://acme.example. |
| Description (`description`) | textarea | Free text about the company. |
| Time Zone (`timeZone`) | text | Optional. The time zone of your SuperOffice tenant, for example Europe/Oslo. SuperOffice keeps date-times in the local time of the tenant; the time zone is detected automatically (reliably for European tenants) and this setting overrides it. Date-times the component returns are always in UTC. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Company ID (`id`) | integer | - |
| Name (`name`) | string | - |
| Department (`department`) | string | - |
| Organization Number (`orgNr`) | string | - |
| Category (`category`) | string | - |
| Business (`business`) | string | - |
| Country (`country`) | string | - |
| Email (`email`) | string | - |
| Phone (`phone`) | string | - |
| Website (`website`) | string | - |
| Description (`description`) | string | - |
| Created Date (`createdDate`) | string | - |
| Updated Date (`updatedDate`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.superoffice.core.CreateCompany",
  "label": "Create Company",
  "description": "Create a company (a contact in SuperOffice). The company starts from the defaults SuperOffice sets for new companies.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:superoffice"
  },
  "quota": {
    "manager": "appmixer:superoffice",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "department": {
            "type": "string"
          },
          "orgNr": {
            "type": "string"
          },
          "categoryId": {
            "type": "string"
          },
          "businessId": {
            "type": "string"
          },
          "countryId": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ]
      },
      "inspector": {
        "inputs": {
          "name": {
            "type": "text",
            "index": 1,
            "label": "Name",
            "tooltip": "The company name."
          },
          "department": {
            "type": "text",
            "index": 2,
            "label": "Department",
            "tooltip": "The department of the company."
          },
          "orgNr": {
            "type": "text",
            "index": 3,
            "label": "Organization Number",
            "tooltip": "The organization (VAT) number."
          },
          "categoryId": {
            "type": "text",
            "index": 4,
            "label": "Category",
            "tooltip": "Pick a category, or type its ID.",
            "source": {
              "url": "/component/appmixer/superoffice/core/ListListItems?outPort=out",
              "data": {
                "properties": {
                  "isSource": true,
                  "listName": "Category"
                },
                "transform": "./ListListItems#toSelectArray"
              }
            }
          },
          "businessId": {
            "type": "text",
            "index": 5,
            "label": "Business",
            "tooltip": "Pick a business, or type its ID.",
            "source": {
              "url": "/component/appmixer/superoffice/core/ListListItems?outPort=out",
              "data": {
                "properties": {
                  "isSource": true,
                  "listName": "Business"
                },
                "transform": "./ListListItems#toSelectArray"
              }
            }
          },
          "countryId": {
            "type": "text",
            "index": 6,
            "label": "Country",
            "tooltip": "Pick a country, or type its ID.",
            "source": {
              "url": "/component/appmixer/superoffice/core/ListListItems?outPort=out",
              "data": {
                "properties": {
                  "isSource": true,
                  "listName": "Country"
                },
                "transform": "./ListListItems#toSelectArray"
              }
            }
          },
          "email": {
            "type": "text",
            "index": 7,
            "label": "Email",
            "tooltip": "Email address of the company."
          },
          "phone": {
            "type": "text",
            "index": 8,
            "label": "Phone",
            "tooltip": "Phone number of the company."
          },
          "website": {
            "type": "text",
            "index": 9,
            "label": "Website",
            "tooltip": "Website of the company, e.g. https://acme.example."
          },
          "description": {
            "type": "textarea",
            "index": 10,
            "label": "Description",
            "tooltip": "Free text about the company."
          },
          "timeZone": {
            "type": "text",
            "index": 11,
            "label": "Time Zone",
            "tooltip": "Optional. The time zone of your SuperOffice tenant, for example Europe/Oslo. SuperOffice keeps date-times in the local time of the tenant; the time zone is detected automatically (reliably for European tenants) and this setting overrides it. Date-times the component returns are always in UTC.",
            "source": {
              "url": "/component/appmixer/superoffice/core/ListTimeZones?outPort=out",
              "data": {
                "transform": "./ListTimeZones#toSelectArray"
              }
            }
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "title": "Company ID",
            "example": 125
          },
          "name": {
            "type": "string",
            "title": "Name",
            "example": "Acme Inc."
          },
          "department": {
            "type": "string",
            "title": "Department",
            "example": "Sales"
          },
          "orgNr": {
            "type": "string",
            "title": "Organization Number",
            "example": "987654321"
          },
          "category": {
            "type": "string",
            "title": "Category",
            "example": "Customer"
          },
          "business": {
            "type": "string",
            "title": "Business",
            "example": "IT"
          },
          "country": {
            "type": "string",
            "title": "Country",
            "example": "Norway"
          },
          "email": {
            "type": "string",
            "title": "Email",
            "example": "info@acme.example"
          },
          "phone": {
            "type": "string",
            "title": "Phone",
            "example": "+47 22 00 00 00"
          },
          "website": {
            "type": "string",
            "title": "Website",
            "example": "https://acme.example"
          },
          "description": {
            "type": "string",
            "title": "Description",
            "example": "Reseller for the Nordic market."
          },
          "createdDate": {
            "type": "string",
            "title": "Created Date",
            "example": "2026-11-16T10:30:00Z"
          },
          "updatedDate": {
            "type": "string",
            "title": "Updated Date",
            "example": "2026-11-17T08:15:00Z"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
