POST Api/v{apiVersion}/AdLocations

Creates a new adlocation

Request Information

URI Parameters

NameDescriptionTypeAdditional information
apiVersion

string

None.

Body Parameters

AdLocationValues
NameDescriptionTypeAdditional information
MediumID

globally unique identifier

None.

Name

string

None.

Description

string

None.

Address

string

None.

IsDigital

boolean

None.

IsRotating

boolean

None.

Type

string

None.

Format

string

None.

Status

AdLocationStatus

None.

Longitude

decimal number

None.

Latitude

decimal number

None.

Notes

string

None.

Request Formats

application/json, text/json

Sample:
{
  "MediumID": "b96f29fb-3755-4ef2-8768-51932bf61a6c",
  "Name": "sample string 1",
  "Description": "sample string 2",
  "Address": "sample string 3",
  "IsDigital": true,
  "IsRotating": true,
  "Type": "sample string 6",
  "Format": "sample string 7",
  "Status": "InActive",
  "Longitude": 8.1,
  "Latitude": 9.1,
  "Notes": "sample string 10"
}

application/xml, text/xml

Sample:
<AdLocationValues xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <Address>sample string 3</Address>
  <Description>sample string 2</Description>
  <Format>sample string 7</Format>
  <IsDigital>true</IsDigital>
  <IsRotating>true</IsRotating>
  <Latitude>9.1</Latitude>
  <Longitude>8.1</Longitude>
  <MediumID>b96f29fb-3755-4ef2-8768-51932bf61a6c</MediumID>
  <Name>sample string 1</Name>
  <Notes>sample string 10</Notes>
  <Status>InActive</Status>
  <Type>sample string 6</Type>
</AdLocationValues>

application/x-www-form-urlencoded

Sample:

Sample not available.

multipart/form-data

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

b96f29fb-3755-4ef2-8768-51932bf61a6c
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Name"

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

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

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

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

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

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

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

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

8.1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Latitude"

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

sample string 10
--MultipartDataMediaFormatterBoundary1q2w3e--

Response Information

Resource Description

AdLocationDetails
NameDescriptionTypeAdditional information
AdLocationID

globally unique identifier

None.

Medium

MediumPreview

None.

Name

string

None.

Description

string

None.

Area

AreaPreview

None.

Address

string

None.

IsDigital

boolean

None.

IsRotating

boolean

None.

Type

string

None.

Format

string

None.

Status

AdLocationStatus

None.

DataCopyright

string

None.

Longitude

decimal number

None.

Latitude

decimal number

None.

Notes

string

None.

CreatedAt

date

None.

CreatedBy

string

None.

ModifiedAt

date

None.

ModifiedBy

string

None.

Response Formats

application/json, text/json

Sample:
{
  "AdLocationID": "b6496450-3fba-4a9f-b24d-c83168ae6ff9",
  "Medium": {
    "MediumID": "30ec2df0-1ea4-4015-807f-ab7267d6c6fe",
    "Supplier": {
      "SupplierID": "10b26916-d73f-461f-a017-f09471d913bb",
      "ParentName": "sample string 2",
      "Name": "sample string 3",
      "Status": "InActive",
      "IsBackendSupplier": true,
      "Contact": "sample string 5",
      "PhoneNumber": "sample string 6"
    },
    "Category": {
      "CategoryID": "8595de58-60dd-4fc5-87d5-429f36af0188",
      "MediumType": "Print",
      "Name": "sample string 2",
      "Status": "InActive"
    },
    "Name": "sample string 2",
    "Type": "Print",
    "SpreadType": "AdLocations",
    "Status": "InActive"
  },
  "Name": "sample string 2",
  "Description": "sample string 3",
  "Area": {
    "AreaID": "576328dd-a3d5-4b76-8f8b-f6d23cb53b3f",
    "ParentID": "079f3389-39cb-4565-b9fb-65b86f8b66b0",
    "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
  },
  "Address": "sample string 4",
  "IsDigital": true,
  "IsRotating": true,
  "Type": "sample string 7",
  "Format": "sample string 8",
  "Status": "InActive",
  "DataCopyright": "sample string 9",
  "Longitude": 10.1,
  "Latitude": 11.1,
  "Notes": "sample string 12",
  "CreatedAt": "2026-01-15T14:13:04.5632361Z",
  "CreatedBy": "sample string 14",
  "ModifiedAt": "2026-01-15T14:13:04.5632361Z",
  "ModifiedBy": "sample string 16"
}

application/xml, text/xml

Sample:
<AdLocationDetails xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <AdLocationID>b6496450-3fba-4a9f-b24d-c83168ae6ff9</AdLocationID>
  <Address>sample string 4</Address>
  <Area>
    <AreaID>576328dd-a3d5-4b76-8f8b-f6d23cb53b3f</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>079f3389-39cb-4565-b9fb-65b86f8b66b0</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>
  </Area>
  <CreatedAt>2026-01-15T15:13:04.5632361+01:00</CreatedAt>
  <CreatedBy>sample string 14</CreatedBy>
  <DataCopyright>sample string 9</DataCopyright>
  <Description>sample string 3</Description>
  <Format>sample string 8</Format>
  <IsDigital>true</IsDigital>
  <IsRotating>true</IsRotating>
  <Latitude>11.1</Latitude>
  <Longitude>10.1</Longitude>
  <Medium>
    <Category>
      <CategoryID>8595de58-60dd-4fc5-87d5-429f36af0188</CategoryID>
      <MediumType>Print</MediumType>
      <Name>sample string 2</Name>
      <Status>InActive</Status>
    </Category>
    <MediumID>30ec2df0-1ea4-4015-807f-ab7267d6c6fe</MediumID>
    <Name>sample string 2</Name>
    <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>10b26916-d73f-461f-a017-f09471d913bb</SupplierID>
    </Supplier>
    <Type>Print</Type>
  </Medium>
  <ModifiedAt>2026-01-15T15:13:04.5632361+01:00</ModifiedAt>
  <ModifiedBy>sample string 16</ModifiedBy>
  <Name>sample string 2</Name>
  <Notes>sample string 12</Notes>
  <Status>InActive</Status>
  <Type>sample string 7</Type>
</AdLocationDetails>

multipart/form-data

Sample:
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AdLocationID"

b6496450-3fba-4a9f-b24d-c83168ae6ff9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.MediumID"

30ec2df0-1ea4-4015-807f-ab7267d6c6fe
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.SupplierID"

10b26916-d73f-461f-a017-f09471d913bb
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.ParentName"

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

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

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

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

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

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

8595de58-60dd-4fc5-87d5-429f36af0188
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Category.MediumType"

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

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

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

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

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

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

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

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

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.AreaID"

576328dd-a3d5-4b76-8f8b-f6d23cb53b3f
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.ParentID"

079f3389-39cb-4565-b9fb-65b86f8b66b0
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.ParentName"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

10.1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Latitude"

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

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

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

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

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

sample string 16
--MultipartDataMediaFormatterBoundary1q2w3e--