POST Api/v{apiVersion}/Mediums

Creates a new medium

Request Information

URI Parameters

Name	Description	Type	Additional information
apiVersion		string	None.

Body Parameters

MediumValues

Name	Type	Additional information
SupplierID	globally unique identifier	None.
CategoryID	globally unique identifier	None.
Name	string	None.
Type	MediumType	None.
SpreadType	SpreadType	None.
Status	MediumStatus	None.
Reference	string	None.
AdSpecificationsHtml	string	None.
HasSelectiveAdLocationBuying	boolean	None.
Notes	string	None.

Request Formats

application/json, text/json

Sample:

{
  "SupplierID": "a203da62-444a-481a-a3d3-50218c454083",
  "CategoryID": "c39946e2-9f94-4f3c-900f-b820a7504c2c",
  "Name": "sample string 1",
  "Type": "Print",
  "SpreadType": "AdLocations",
  "Status": "InActive",
  "Reference": "sample string 2",
  "AdSpecificationsHtml": "sample string 3",
  "HasSelectiveAdLocationBuying": true,
  "Notes": "sample string 5"
}

application/xml, text/xml

Sample:

<MediumValues xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <AdSpecificationsHtml>sample string 3</AdSpecificationsHtml>
  <CategoryID>c39946e2-9f94-4f3c-900f-b820a7504c2c</CategoryID>
  <HasSelectiveAdLocationBuying>true</HasSelectiveAdLocationBuying>
  <Name>sample string 1</Name>
  <Notes>sample string 5</Notes>
  <Reference>sample string 2</Reference>
  <SpreadType>AdLocations</SpreadType>
  <Status>InActive</Status>
  <SupplierID>a203da62-444a-481a-a3d3-50218c454083</SupplierID>
  <Type>Print</Type>
</MediumValues>

application/x-www-form-urlencoded

Sample:

Sample not available.

multipart/form-data

Sample:

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

a203da62-444a-481a-a3d3-50218c454083
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CategoryID"

c39946e2-9f94-4f3c-900f-b820a7504c2c
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Name"

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

Print
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SpreadType"

AdLocations
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Status"

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

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

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

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Notes"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e--

Response Information

Resource Description

MediumDetails

Name	Type	Additional information
MediumID	globally unique identifier	None.
Supplier	SupplierPreview	None.
Category	CategoryPreview	None.
Name	string	None.
Type	MediumType	None.
SpreadType	SpreadType	None.
Status	MediumStatus	None.
Logo	FilePreview	None.
Reference	string	None.
CoverageTotalValue	decimal number	None.
AdLocationTotalCount	integer	None.
AdSpecificationsHtml	string	None.
HasSelectiveAdLocationBuying	boolean	None.
Notes	string	None.
CreatedAt	date	None.
CreatedBy	string	None.
ModifiedAt	date	None.
ModifiedBy	string	None.

Response Formats

application/json

Sample:

{
  "MediumID": "79518426-784d-43d1-9aea-796357cf6a77",
  "Supplier": {
    "SupplierID": "58c40fcb-a51d-4227-b619-1feea2c73107",
    "ParentName": "sample string 2",
    "Name": "sample string 3",
    "Status": "InActive",
    "IsBackendSupplier": true,
    "Contact": "sample string 5",
    "PhoneNumber": "sample string 6"
  },
  "Category": {
    "CategoryID": "ef9fa7ce-2ac2-4ff7-af0f-bdc16c4baac4",
    "MediumType": "Print",
    "Name": "sample string 2",
    "Status": "InActive"
  },
  "Name": "sample string 2",
  "Type": "Print",
  "SpreadType": "AdLocations",
  "Status": "InActive",
  "Logo": {
    "FileID": "3386a2af-768a-4a07-a3e9-44cbde915403",
    "LinkedEntityID": "7123e35d-b2df-454b-bbae-8ebecfad69d6",
    "LinkedPropertyName": "sample string 3",
    "FileName": "sample string 4",
    "ContentType": "application/",
    "BlobUrl": "https://hier.ralphkamphuis.nl/api/v1/files/3386a2af-768a-4a07-a3e9-44cbde915403/blob?205ad343-a83d-4602-9159-422499435a14"
  },
  "Reference": "sample string 3",
  "CoverageTotalValue": 1.1,
  "AdLocationTotalCount": 1,
  "AdSpecificationsHtml": "sample string 4",
  "HasSelectiveAdLocationBuying": true,
  "Notes": "sample string 6",
  "CreatedAt": "2026-01-15T14:13:04.0788604Z",
  "CreatedBy": "sample string 8",
  "ModifiedAt": "2026-01-15T14:13:04.0788604Z",
  "ModifiedBy": "sample string 10"
}

text/json

Sample:

{
  "MediumID": "79518426-784d-43d1-9aea-796357cf6a77",
  "Supplier": {
    "SupplierID": "58c40fcb-a51d-4227-b619-1feea2c73107",
    "ParentName": "sample string 2",
    "Name": "sample string 3",
    "Status": "InActive",
    "IsBackendSupplier": true,
    "Contact": "sample string 5",
    "PhoneNumber": "sample string 6"
  },
  "Category": {
    "CategoryID": "ef9fa7ce-2ac2-4ff7-af0f-bdc16c4baac4",
    "MediumType": "Print",
    "Name": "sample string 2",
    "Status": "InActive"
  },
  "Name": "sample string 2",
  "Type": "Print",
  "SpreadType": "AdLocations",
  "Status": "InActive",
  "Logo": {
    "FileID": "3386a2af-768a-4a07-a3e9-44cbde915403",
    "LinkedEntityID": "7123e35d-b2df-454b-bbae-8ebecfad69d6",
    "LinkedPropertyName": "sample string 3",
    "FileName": "sample string 4",
    "ContentType": "application/",
    "BlobUrl": "https://hier.ralphkamphuis.nl/api/v1/files/3386a2af-768a-4a07-a3e9-44cbde915403/blob?36395e51-c26d-4c24-a383-cb4c8010928e"
  },
  "Reference": "sample string 3",
  "CoverageTotalValue": 1.1,
  "AdLocationTotalCount": 1,
  "AdSpecificationsHtml": "sample string 4",
  "HasSelectiveAdLocationBuying": true,
  "Notes": "sample string 6",
  "CreatedAt": "2026-01-15T14:13:04.0788604Z",
  "CreatedBy": "sample string 8",
  "ModifiedAt": "2026-01-15T14:13:04.0788604Z",
  "ModifiedBy": "sample string 10"
}

application/xml, text/xml

Sample:

<MediumDetails xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <AdLocationTotalCount>1</AdLocationTotalCount>
  <AdSpecificationsHtml>sample string 4</AdSpecificationsHtml>
  <Category>
    <CategoryID>ef9fa7ce-2ac2-4ff7-af0f-bdc16c4baac4</CategoryID>
    <MediumType>Print</MediumType>
    <Name>sample string 2</Name>
    <Status>InActive</Status>
  </Category>
  <CoverageTotalValue>1.1</CoverageTotalValue>
  <CreatedAt>2026-01-15T15:13:04.0788604+01:00</CreatedAt>
  <CreatedBy>sample string 8</CreatedBy>
  <HasSelectiveAdLocationBuying>true</HasSelectiveAdLocationBuying>
  <Logo>
    <FileID>3386a2af-768a-4a07-a3e9-44cbde915403</FileID>
    <FileName>sample string 4</FileName>
    <LinkedEntityID>7123e35d-b2df-454b-bbae-8ebecfad69d6</LinkedEntityID>
    <LinkedPropertyName>sample string 3</LinkedPropertyName>
  </Logo>
  <MediumID>79518426-784d-43d1-9aea-796357cf6a77</MediumID>
  <ModifiedAt>2026-01-15T15:13:04.0788604+01:00</ModifiedAt>
  <ModifiedBy>sample string 10</ModifiedBy>
  <Name>sample string 2</Name>
  <Notes>sample string 6</Notes>
  <Reference>sample string 3</Reference>
  <SpreadType>AdLocations</SpreadType>
  <Status>InActive</Status>
  <Supplier>
    <Contact>sample string 5</Contact>
    <IsBackendSupplier>true</IsBackendSupplier>
    <Name>sample string 3</Name>
    <ParentName>sample string 2</ParentName>
    <PhoneNumber>sample string 6</PhoneNumber>
    <Status>InActive</Status>
    <SupplierID>58c40fcb-a51d-4227-b619-1feea2c73107</SupplierID>
  </Supplier>
  <Type>Print</Type>
</MediumDetails>

multipart/form-data

Sample:

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

79518426-784d-43d1-9aea-796357cf6a77
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Supplier.SupplierID"

58c40fcb-a51d-4227-b619-1feea2c73107
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Supplier.ParentName"

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

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

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Supplier.IsBackendSupplier"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Supplier.Contact"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Supplier.PhoneNumber"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Category.CategoryID"

ef9fa7ce-2ac2-4ff7-af0f-bdc16c4baac4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Category.MediumType"

Print
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Category.Name"

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

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

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

Print
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="SpreadType"

AdLocations
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.FileID"

3386a2af-768a-4a07-a3e9-44cbde915403
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Logo.LinkedEntityID"

7123e35d-b2df-454b-bbae-8ebecfad69d6
--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/3386a2af-768a-4a07-a3e9-44cbde915403/blob?ba4cfe2e-71fa-4706-b452-ba04d66f6e39
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Reference"

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

1.1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AdLocationTotalCount"

1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AdSpecificationsHtml"

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

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Notes"

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

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

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

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

sample string 10
--MultipartDataMediaFormatterBoundary1q2w3e--