POST Api/v{apiVersion}/Operators

Creates a new operator

Request Information

URI Parameters

Name	Description	Type	Additional information
apiVersion		string	None.

Body Parameters

OperatorValues

Name	Type	Additional information
ParentID	globally unique identifier	None.
Name	string	None.
Status	OperatorStatus	None.
IetfLanguageTag	string	None.
DefaultCurrencySymbol	string	None.
Address	string	None.
Postcode	string	None.
CityID	globally unique identifier	None.
CocNumber	string	None.
VatNumber	string	None.
Website	string	None.
PhoneNumber	string	None.
EmailAddress	string	None.
Notes	string	None.

Request Formats

application/json, text/json

Sample:

{
  "ParentID": "5e83c0f6-4397-4fc9-a11a-7c2b1fadb739",
  "Name": "sample string 1",
  "Status": "InActive",
  "IetfLanguageTag": "sample string 2",
  "DefaultCurrencySymbol": "sample string 3",
  "Address": "sample string 4",
  "Postcode": "sample string 5",
  "CityID": "7194b208-22db-499a-9d42-a697d888bfd2",
  "CocNumber": "sample string 6",
  "VatNumber": "sample string 7",
  "Website": "sample string 8",
  "PhoneNumber": "sample string 9",
  "EmailAddress": "sample string 10",
  "Notes": "sample string 11"
}

application/xml, text/xml

Sample:

<OperatorValues xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <Address>sample string 4</Address>
  <CityID>7194b208-22db-499a-9d42-a697d888bfd2</CityID>
  <CocNumber>sample string 6</CocNumber>
  <DefaultCurrencySymbol>sample string 3</DefaultCurrencySymbol>
  <EmailAddress>sample string 10</EmailAddress>
  <IetfLanguageTag>sample string 2</IetfLanguageTag>
  <Name>sample string 1</Name>
  <Notes>sample string 11</Notes>
  <ParentID>5e83c0f6-4397-4fc9-a11a-7c2b1fadb739</ParentID>
  <PhoneNumber>sample string 9</PhoneNumber>
  <Postcode>sample string 5</Postcode>
  <Status>InActive</Status>
  <VatNumber>sample string 7</VatNumber>
  <Website>sample string 8</Website>
</OperatorValues>

application/x-www-form-urlencoded

Sample:

Sample not available.

multipart/form-data

Sample:

--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ParentID"

5e83c0f6-4397-4fc9-a11a-7c2b1fadb739
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Name"

sample string 1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="IetfLanguageTag"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="DefaultCurrencySymbol"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Postcode"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CityID"

7194b208-22db-499a-9d42-a697d888bfd2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CocNumber"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="VatNumber"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Website"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="PhoneNumber"

sample string 9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EmailAddress"

sample string 10
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Notes"

sample string 11
--MultipartDataMediaFormatterBoundary1q2w3e--

Response Information

Resource Description

OperatorDetails

Name	Type	Additional information
OperatorID	globally unique identifier	None.
Parent	OperatorPreview	None.
Name	string	None.
Status	OperatorStatus	None.
IetfLanguageTag	string	None.
DefaultCurrencySymbol	string	None.
Address	string	None.
Postcode	string	None.
City	AreaPreview	None.
CocNumber	string	None.
VatNumber	string	None.
Website	string	None.
PhoneNumber	string	None.
EmailAddress	string	None.
Logo	FilePreview	None.
Notes	string	None.
CreatedAt	date	None.
CreatedBy	string	None.
ModifiedAt	date	None.
ModifiedBy	string	None.

Response Formats

application/json

Sample:

{
  "OperatorID": "61c7d143-edc9-4041-a059-f5f4e2fcc242",
  "Parent": {
    "OperatorID": "ae828a94-540f-4e8a-8fe0-a043a4a4b074",
    "ParentName": "sample string 2",
    "Name": "sample string 3",
    "Status": "InActive",
    "Address": "sample string 4",
    "Postcode": "sample string 5",
    "City": {
      "AreaID": "94ff8bee-377b-4d83-9eb7-7aa4316eb5b0",
      "ParentID": "2b3e3b8a-8c61-4c93-a17c-27319ea89bff",
      "ParentName": "sample string 2",
      "SupplierName": "sample string 3",
      "CustomerName": "sample string 4",
      "StoreName": "sample string 5",
      "Code": "sample string 6",
      "Name": "sample string 7",
      "Type": "Neighbourhood",
      "Status": "InActive",
      "OwnerName": "sample string 8",
      "Population": 9,
      "Mailboxes": 10
    },
    "PhoneNumber": "sample string 6",
    "EmailAddress": "sample string 7"
  },
  "Name": "sample string 2",
  "Status": "InActive",
  "IetfLanguageTag": "sample string 3",
  "DefaultCurrencySymbol": "sample string 4",
  "Address": "sample string 5",
  "Postcode": "sample string 6",
  "City": {
    "AreaID": "94ff8bee-377b-4d83-9eb7-7aa4316eb5b0",
    "ParentID": "2b3e3b8a-8c61-4c93-a17c-27319ea89bff",
    "ParentName": "sample string 2",
    "SupplierName": "sample string 3",
    "CustomerName": "sample string 4",
    "StoreName": "sample string 5",
    "Code": "sample string 6",
    "Name": "sample string 7",
    "Type": "Neighbourhood",
    "Status": "InActive",
    "OwnerName": "sample string 8",
    "Population": 9,
    "Mailboxes": 10
  },
  "CocNumber": "sample string 7",
  "VatNumber": "sample string 8",
  "Website": "sample string 9",
  "PhoneNumber": "sample string 10",
  "EmailAddress": "sample string 11",
  "Logo": {
    "FileID": "ca4696ba-ae91-48ef-bb1c-c88b4304b9c4",
    "LinkedEntityID": "39ec72ab-499f-4c26-bf10-1a0eda73e7e5",
    "LinkedPropertyName": "sample string 3",
    "FileName": "sample string 4",
    "ContentType": "application/",
    "BlobUrl": "https://hier.ralphkamphuis.nl/api/v1/files/ca4696ba-ae91-48ef-bb1c-c88b4304b9c4/blob?c298fee3-6045-436f-ad1c-8e25c25005b2"
  },
  "Notes": "sample string 12",
  "CreatedAt": "2026-01-15T14:11:34.8432268Z",
  "CreatedBy": "sample string 14",
  "ModifiedAt": "2026-01-15T14:11:34.8432268Z",
  "ModifiedBy": "sample string 16"
}

text/json

Sample:

{
  "OperatorID": "61c7d143-edc9-4041-a059-f5f4e2fcc242",
  "Parent": {
    "OperatorID": "ae828a94-540f-4e8a-8fe0-a043a4a4b074",
    "ParentName": "sample string 2",
    "Name": "sample string 3",
    "Status": "InActive",
    "Address": "sample string 4",
    "Postcode": "sample string 5",
    "City": {
      "AreaID": "94ff8bee-377b-4d83-9eb7-7aa4316eb5b0",
      "ParentID": "2b3e3b8a-8c61-4c93-a17c-27319ea89bff",
      "ParentName": "sample string 2",
      "SupplierName": "sample string 3",
      "CustomerName": "sample string 4",
      "StoreName": "sample string 5",
      "Code": "sample string 6",
      "Name": "sample string 7",
      "Type": "Neighbourhood",
      "Status": "InActive",
      "OwnerName": "sample string 8",
      "Population": 9,
      "Mailboxes": 10
    },
    "PhoneNumber": "sample string 6",
    "EmailAddress": "sample string 7"
  },
  "Name": "sample string 2",
  "Status": "InActive",
  "IetfLanguageTag": "sample string 3",
  "DefaultCurrencySymbol": "sample string 4",
  "Address": "sample string 5",
  "Postcode": "sample string 6",
  "City": {
    "AreaID": "94ff8bee-377b-4d83-9eb7-7aa4316eb5b0",
    "ParentID": "2b3e3b8a-8c61-4c93-a17c-27319ea89bff",
    "ParentName": "sample string 2",
    "SupplierName": "sample string 3",
    "CustomerName": "sample string 4",
    "StoreName": "sample string 5",
    "Code": "sample string 6",
    "Name": "sample string 7",
    "Type": "Neighbourhood",
    "Status": "InActive",
    "OwnerName": "sample string 8",
    "Population": 9,
    "Mailboxes": 10
  },
  "CocNumber": "sample string 7",
  "VatNumber": "sample string 8",
  "Website": "sample string 9",
  "PhoneNumber": "sample string 10",
  "EmailAddress": "sample string 11",
  "Logo": {
    "FileID": "ca4696ba-ae91-48ef-bb1c-c88b4304b9c4",
    "LinkedEntityID": "39ec72ab-499f-4c26-bf10-1a0eda73e7e5",
    "LinkedPropertyName": "sample string 3",
    "FileName": "sample string 4",
    "ContentType": "application/",
    "BlobUrl": "https://hier.ralphkamphuis.nl/api/v1/files/ca4696ba-ae91-48ef-bb1c-c88b4304b9c4/blob?cfd431c8-edfc-4da3-9ad1-378e72cec47a"
  },
  "Notes": "sample string 12",
  "CreatedAt": "2026-01-15T14:11:34.8432268Z",
  "CreatedBy": "sample string 14",
  "ModifiedAt": "2026-01-15T14:11:34.8432268Z",
  "ModifiedBy": "sample string 16"
}

application/xml, text/xml

Sample:

<OperatorDetails xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <Address>sample string 5</Address>
  <City>
    <AreaID>94ff8bee-377b-4d83-9eb7-7aa4316eb5b0</AreaID>
    <Code>sample string 6</Code>
    <CustomerName>sample string 4</CustomerName>
    <Mailboxes>10</Mailboxes>
    <Name>sample string 7</Name>
    <OwnerName>sample string 8</OwnerName>
    <ParentID>2b3e3b8a-8c61-4c93-a17c-27319ea89bff</ParentID>
    <ParentName>sample string 2</ParentName>
    <Population>9</Population>
    <Status>InActive</Status>
    <StoreName>sample string 5</StoreName>
    <SupplierName>sample string 3</SupplierName>
    <Type>Neighbourhood</Type>
  </City>
  <CocNumber>sample string 7</CocNumber>
  <CreatedAt>2026-01-15T15:11:34.8432268+01:00</CreatedAt>
  <CreatedBy>sample string 14</CreatedBy>
  <DefaultCurrencySymbol>sample string 4</DefaultCurrencySymbol>
  <EmailAddress>sample string 11</EmailAddress>
  <IetfLanguageTag>sample string 3</IetfLanguageTag>
  <Logo>
    <FileID>ca4696ba-ae91-48ef-bb1c-c88b4304b9c4</FileID>
    <FileName>sample string 4</FileName>
    <LinkedEntityID>39ec72ab-499f-4c26-bf10-1a0eda73e7e5</LinkedEntityID>
    <LinkedPropertyName>sample string 3</LinkedPropertyName>
  </Logo>
  <ModifiedAt>2026-01-15T15:11:34.8432268+01:00</ModifiedAt>
  <ModifiedBy>sample string 16</ModifiedBy>
  <Name>sample string 2</Name>
  <Notes>sample string 12</Notes>
  <OperatorID>61c7d143-edc9-4041-a059-f5f4e2fcc242</OperatorID>
  <Parent>
    <Address>sample string 4</Address>
    <City>
      <AreaID>94ff8bee-377b-4d83-9eb7-7aa4316eb5b0</AreaID>
      <Code>sample string 6</Code>
      <CustomerName>sample string 4</CustomerName>
      <Mailboxes>10</Mailboxes>
      <Name>sample string 7</Name>
      <OwnerName>sample string 8</OwnerName>
      <ParentID>2b3e3b8a-8c61-4c93-a17c-27319ea89bff</ParentID>
      <ParentName>sample string 2</ParentName>
      <Population>9</Population>
      <Status>InActive</Status>
      <StoreName>sample string 5</StoreName>
      <SupplierName>sample string 3</SupplierName>
      <Type>Neighbourhood</Type>
    </City>
    <EmailAddress>sample string 7</EmailAddress>
    <Name>sample string 3</Name>
    <OperatorID>ae828a94-540f-4e8a-8fe0-a043a4a4b074</OperatorID>
    <ParentName>sample string 2</ParentName>
    <PhoneNumber>sample string 6</PhoneNumber>
    <Postcode>sample string 5</Postcode>
    <Status>InActive</Status>
  </Parent>
  <PhoneNumber>sample string 10</PhoneNumber>
  <Postcode>sample string 6</Postcode>
  <Status>InActive</Status>
  <VatNumber>sample string 8</VatNumber>
  <Website>sample string 9</Website>
</OperatorDetails>

multipart/form-data

Sample:

--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="OperatorID"

61c7d143-edc9-4041-a059-f5f4e2fcc242
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.OperatorID"

ae828a94-540f-4e8a-8fe0-a043a4a4b074
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.ParentName"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.Name"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.Address"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.Postcode"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.AreaID"

94ff8bee-377b-4d83-9eb7-7aa4316eb5b0
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.ParentID"

2b3e3b8a-8c61-4c93-a17c-27319ea89bff
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.ParentName"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.SupplierName"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.CustomerName"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.StoreName"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.Code"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.Name"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.Type"

Neighbourhood
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.OwnerName"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.Population"

9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.City.Mailboxes"

10
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.PhoneNumber"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Parent.EmailAddress"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Name"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="IetfLanguageTag"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="DefaultCurrencySymbol"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Address"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Postcode"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.AreaID"

94ff8bee-377b-4d83-9eb7-7aa4316eb5b0
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.ParentID"

2b3e3b8a-8c61-4c93-a17c-27319ea89bff
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.ParentName"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.SupplierName"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.CustomerName"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.StoreName"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.Code"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.Name"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.Type"

Neighbourhood
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.OwnerName"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.Population"

9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="City.Mailboxes"

10
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CocNumber"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="VatNumber"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Website"

sample string 9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="PhoneNumber"

sample string 10
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="EmailAddress"

sample string 11
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.FileID"

ca4696ba-ae91-48ef-bb1c-c88b4304b9c4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.LinkedEntityID"

39ec72ab-499f-4c26-bf10-1a0eda73e7e5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.LinkedPropertyName"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.FileName"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.ContentType"

application/
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.BlobUrl"

https://hier.ralphkamphuis.nl/api/v1/files/ca4696ba-ae91-48ef-bb1c-c88b4304b9c4/blob?3e64878b-5d5e-451a-9937-268670deb3fc
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Notes"

sample string 12
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CreatedAt"

2026-01-15T15:11:34.8432268+01:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CreatedBy"

sample string 14
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ModifiedAt"

2026-01-15T15:11:34.8432268+01:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ModifiedBy"

sample string 16
--MultipartDataMediaFormatterBoundary1q2w3e--