Website logo

Create a job Position

Creates a job Position

URL: https://api.trademe.co.nz/v1/Jobs/Positions.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Query String parameters

dry_run Boolean (optional)

Whether to do a dry run of the create operation. When doing a dry run, no data is updated or saved.

POST Data

<PositionSaveRequest>

Title String (required)

The title of the position

PositionListings Collection of <PositionListingSaveRequest> (optional)

The position listings for the position. When the state is external these will be created as public Trade Me listings. At present you can only have one live position listing per position, and you must provide a position listing to create an external position.

PositionListingId Long Integer (optional)

The id of the position listing, if it already exists. Omit from request if creating a new position listing.

ShortDescription String (optional)

A short description used to differentiate the listing

ReferenceId String (optional)

A reference id to help track the listing

PayAndBenefits String (optional)

A description of the pay and benefits of the position

ContactDetails <PositionListingContactDetailsSave> (optional)

Details for who to contact regarding the listing

ContactName String (optional)

The name of the person to contact regarding the listing

PreferredApplicationMethod String (optional)

The preferred way for applicants to apply

EmailAddress String (optional)

The email address of the person to contact regarding the listing

ApplicationUrl String (optional)

The url to send applicants to if using an off site application method

PhoneNumbers Collection of <PhoneNumberDetails> (optional)

Phone numbers of people to contact regarding the listing

Prefix String (optional)

The prefix of the phone number

Number String (optional)

The rest of the phone number

Descriptions Collection of <PositionListingDescription> (optional)

The descriptions of the position listing

Type String (optional)

The type of the description

Text String (optional)

The text of the description

Promotions <PositionListingPromotionSave> (optional)

The promotions for the position listing

BundleType Enumeration (optional)

The type of promotion bundle

None 0

None

Bronze 1

Bronze

Silver 2

Silver

Gold 3

Gold

Platinum 4

Platinum

Fifth 5

Fifth

Sixth 6

Sixth

PromotionData <PromotionDataSave> (optional)

The data required for the promotion bundle

Branding Collection of <PositionBrandingItemSave> (optional)

The branding for the position listing

BrandingId Long Integer (required)

The id of the branding item

BrandingType String (required)

The type of the branding item: Logo or Banner

BulletPoints Collection of String (optional)

The bullet points for the featured position listing

EnabledPromotions Collection of Enumeration (optional)

The promotions that apply to the position listing

Featured 1

Position listing is featured

Branded 2

Position listing is branded

SevenDayListing 3

Position listing is a seven day listing

BulletPoints 4

Position listing can have bullet points

CandidateDatabaseAccess 5

Candidate database access granted

Photos 6

Position listing can have photos

Video 7

Position listing can have videos

PromotedListing 8

Position listing can have promoted listing

PhotoIds Collection of Long Integer (optional)

The list of photo IDs to be displayed with the position

VideoKey String (optional)

The id of the video to be displayed with the position. Only YouTube video ids are supported.

SalaryOptIn Boolean (optional)

Indicates if the advertiser has opted in to display salary data in LDP/SRP.

PositionCompanyName String (optional)

The name of the company where the position is vacant

CategoryIds Collection of Integer (optional)

The IDs of the categories for the position. Currently only one category ID is supported.

PayType String (optional)

Indicates the type of pay for the position. e.g. Hourly or salary

PayMin Number (optional)

The minimum pay for the position.

PayMax Number (optional)

The maximum pay for the position.

EmploymentDurationType String (optional)

Indicates the type of duration for the position

EmploymentType String (optional)

Indicates the type of employment for the position

Locations Collection of <PositionLocation> (optional)

The locations of the position

DistrictId Integer (optional)

The district id of the location

PublishedState String (required)

The published state for the position: Draft or External

IsEntryLevel Boolean (optional)

Indicates whether this is an entry level position

IsWorkFromHome Boolean (optional)

Indicates whether working from home is available for this position

DraftId String (optional)

The draft id (guid) from job smart (if present)

Returns

<PositionSaveResponse>

Information about the creation of a position

Position <Position> or null

The details of the saved position. Is not present during a dry run as nothing is saved.

PositionId Long Integer

The id of the position

PublishedState String or null

The published state of the position

Title String or null

The title of the position

DateCreated DateTime

The date the position was created

DateModified DateTime

The date the position was modified

DateArchived DateTime or null

The date the position was archived

HasLiveListing Boolean

Whether the position has any live listings

Listings Collection of <PositionListingDetails> or null

The listings for the position

PositionListingId Long Integer

The id of the listing

ListingId Long Integer or null

The id of the listing

StartDate DateTime or null

The start date of the listing

EndDate DateTime or null

The end date of the listing

IsLive Boolean

Whether the listing is live

IsAccessible Boolean

Whether the listing is accessible

ShortDescription String or null

A short description used to differentiate the listing

ReferenceId String or null

A reference id to help track the listing

PayAndBenefits String or null

A description of the pay and benefits of the position

ContactDetails <PositionListingContactDetails> or null

Details for who to contact regarding the listing

ContactName String or null

The name of the person to contact regarding the listing

PreferredApplicationMethod String or null

The preferred way for applicants to apply

EmailAddress String or null

The email address of the person to contact regarding the listing

ApplicationUrl String or null

The url to send applicants to if using an off site application method

PhoneNumbers Collection of <PhoneNumberDetails> or null

Phone numbers of people to contact regarding the listing

Prefix String or null

The prefix of the phone number

Number String or null

The rest of the phone number

Descriptions Collection of <PositionListingDescription> or null

The descriptions of the position listing

Type String or null

The type of the description

Text String or null

The text of the description

Promotions <PositionListingPromotion> or null

The promotions of the position listing

BundleType Enumeration

The type of promotion bundle

None 0

None

Bronze 1

Bronze

Silver 2

Silver

Gold 3

Gold

Platinum 4

Platinum

Fifth 5

Fifth

Sixth 6

Sixth

PromotionData <PromotionData> or null

The data required for the promotion bundle

Branding Collection of <PromotionBrandingItem> or null

The branding for the position listing

BrandingId Long Integer

The id of the branding item

BrandingType String or null

The type of the branding item: Logo or Banner

BrandingUri String or null

The uri for the branding image

IsDeleted Boolean

Whether the branding is deleted

BulletPoints Collection of String or null

The bullet points for the featured position listing

CandidateAccessQuota Integer or null

The available quota for profile unlocks in the candidate database

EnabledPromotions Collection of Enumeration or null

The promotions that apply to the position listing

Featured 1

Position listing is featured

Branded 2

Position listing is branded

SevenDayListing 3

Position listing is a seven day listing

BulletPoints 4

Position listing can have bullet points

CandidateDatabaseAccess 5

Candidate database access granted

Photos 6

Position listing can have photos

Video 7

Position listing can have videos

PromotedListing 8

Position listing can have promoted listing

PhotoIds Collection of Long Integer or null

The photo IDs of the position listing

PhotoDetails Collection of <PositionListingPhotoDetail> or null

A collection of photos for the listing. This collection is read-only.

PhotoId Long Integer

The id of the photo

Urls <PositionListingPhotoUrls> or null

All the photo urls for different sized versions of the photo.

Thumbnail String or null

The URL for the thumbnail sized photo (always 85x64, with white borders).

List String or null

The URL for the list view sized photo (scaled down to fit 160x120).

Medium String or null

The URL for the medium sized photo (scaled down to fit 175x175).

Gallery String or null

The URL for the gallery sized photo (scaled down to fit 233x176).

Large String or null

The URL for the large sized photo (scaled down to fit 352x264).

FullSize String or null

The URL for the full sized photo (scaled down to fit 670x502).

PlusSize String or null

The URL for the plus sized photo (scaled down to fit).

TransformData <PositionListingPhotoTransformData> or null

The transform information if the photo was transformed. Null otherwise.

SourcePhotoDetails <PositionListingSourcePhotoDetails> or null

Details of the original source photo used for the transformation.

PhotoId Long Integer

The id of the original source photo used for the transformation.

Urls <PositionListingPhotoUrls> or null

The photo urls for different sized versions of the source photo.

(This type has already been defined)
Dimensions <PositionListingPhotoDimensions> or null

The dimensions of the source photo.

Width Integer

The width of the photo in pixels.

Height Integer

The height of the photo in pixels.

Rotation Integer

The number of degrees the original was rotated clockwise.

Crop <BoundingBox> or null

The bounding box of where the original photo was cropped.

Min <BoundingPoint> or null

A point representing the top left of the bounding box

X Integer

The point on the X axis

Y Integer

The point on the Y axis

Max <BoundingPoint> or null

A point representing the bottom left of the bounding box

(This type has already been defined)
Dimensions <PositionListingPhotoDimensions> or null

The dimensions of the photo. If the photo has been transformed (eg. cropped or rotated), it will be the transformed photo dimensions.

(This type has already been defined)
Video <PositionListingVideoDetails> or null

Details of the video for the listing.

VideoKey String or null

The id of the video

Thumbnails Collection of <PositionListingVideoThumbnail> or null

Thumbnails for the video.

Url String or null

The url of the thumbnail

Size String or null

The size of the thumbnail. Possible values are "Index", "Medium" and "High".

Width Integer or null

The width of the thumbnail

Height Integer or null

The height of the thumbnail

SalaryOptIn Boolean

Indicates if the advertiser has opted in to display salary data in LDP/SRP.

OwnerCompanyId Long Integer

The id of the company who owns the position

PositionCompanyName String or null

The name of the company where the position is vacant

CategoryIds Collection of Integer or null

The IDs of the categories for the position

PayType String or null

Indicates the type of pay for the position. e.g. Hourly or salary

PayMin Number or null

The minimum pay for the position

PayMax Number or null

The maximum pay for the position

EmploymentDurationType String or null

Indicates the type of duration for the position

EmploymentType String or null

Indicates the type of employment for the position

Self <Link> or null

A link to retrieve this position resource

Href String or null

An HREF representing the uri to the resource

Rel String or null

A REL representing the relationship between the sending resource and the linked resource

Prompt String or null

A PROMPT, optional display text to represent the resource to a user

Method String or null

A METHOD, optional field to represent the HTTP method/verb to use. If not provided, default to GET.

Locations Collection of <PositionLocation> or null

The locations of the position

DistrictId Integer or null

The district id of the location

IsEntryLevel Boolean

Indicates whether this is an entry level position

IsWorkFromHome Boolean

Indicates whether working from home is available for this position

FeeSummary <FeeSummary> or null

The details of the fees to create a position and listing

TotalCost Number

The total price for the position.

TotalCostGstExcluded Number

The total price for the position excluding GST.

InsufficientBalance Boolean

Indicates the member has insufficient funds to pay the total price for the position.

MinimumRequiredTopUpAmount Number or null

The minimum top up amount required in order to pay for this position

FeeItems Collection of <FeeItem> or null

A collection of fee items.

Type String or null

The transaction type.

Amount Number

The amount that will be charged

AmountGstExcluded Number

The amount excluding GST

WillBeInvoiced Boolean

Indicates whether this fee item will be invoiced, rather than deducted from the member's trade me balance.

ProvidingSource <FeeItemProvidingSource> or null

The providing source for this item when the member doesn't have to pay for it

Name String or null

The name of the providing source.

Remaining Integer

The number of items remaining in this source, or 0 if the source is unlimited.

IsUnlimited Boolean

True if it is possible to create unlimited listings at the provided rate

Example XML Request (switch to JSON)

<PositionSaveRequest xmlns="http://api.trademe.co.nz/v1">
  <Title>ABC</Title>
  <PositionListings>
    <PositionListingSaveRequest>
      <PositionListingId>123</PositionListingId>
      <ShortDescription>ABC</ShortDescription>
      <ReferenceId>ABC</ReferenceId>
      <PayAndBenefits>ABC</PayAndBenefits>
      <ContactDetails>
        <ContactName>ABC</ContactName>
        <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
        <EmailAddress>ABC</EmailAddress>
        <ApplicationUrl>ABC</ApplicationUrl>
        <PhoneNumbers>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
        </PhoneNumbers>
      </ContactDetails>
      <Descriptions>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
      </Descriptions>
      <Promotions>
        <BundleType>None</BundleType>
        <PromotionData>
          <Branding>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
          </Branding>
          <BulletPoints>
            <string>ABC</string>
            <string>ABC</string>
          </BulletPoints>
        </PromotionData>
        <EnabledPromotions>
          <PromotionType>Featured</PromotionType>
          <PromotionType>Featured</PromotionType>
        </EnabledPromotions>
      </Promotions>
      <PhotoIds>
        <long>123</long>
        <long>123</long>
      </PhotoIds>
      <VideoKey>ABC</VideoKey>
      <SalaryOptIn>false</SalaryOptIn>
    </PositionListingSaveRequest>
    <PositionListingSaveRequest>
      <PositionListingId>123</PositionListingId>
      <ShortDescription>ABC</ShortDescription>
      <ReferenceId>ABC</ReferenceId>
      <PayAndBenefits>ABC</PayAndBenefits>
      <ContactDetails>
        <ContactName>ABC</ContactName>
        <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
        <EmailAddress>ABC</EmailAddress>
        <ApplicationUrl>ABC</ApplicationUrl>
        <PhoneNumbers>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
          <PhoneNumberDetails>
            <Prefix>ABC</Prefix>
            <Number>ABC</Number>
          </PhoneNumberDetails>
        </PhoneNumbers>
      </ContactDetails>
      <Descriptions>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
        <PositionListingDescription>
          <Type>ABC</Type>
          <Text>ABC</Text>
        </PositionListingDescription>
      </Descriptions>
      <Promotions>
        <BundleType>None</BundleType>
        <PromotionData>
          <Branding>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
            <PositionBrandingItemSave>
              <BrandingId>123</BrandingId>
              <BrandingType>ABC</BrandingType>
            </PositionBrandingItemSave>
          </Branding>
          <BulletPoints>
            <string>ABC</string>
            <string>ABC</string>
          </BulletPoints>
        </PromotionData>
        <EnabledPromotions>
          <PromotionType>Featured</PromotionType>
          <PromotionType>Featured</PromotionType>
        </EnabledPromotions>
      </Promotions>
      <PhotoIds>
        <long>123</long>
        <long>123</long>
      </PhotoIds>
      <VideoKey>ABC</VideoKey>
      <SalaryOptIn>false</SalaryOptIn>
    </PositionListingSaveRequest>
  </PositionListings>
  <PositionCompanyName>ABC</PositionCompanyName>
  <CategoryIds>
    <int>123</int>
    <int>123</int>
  </CategoryIds>
  <PayType>ABC</PayType>
  <PayMin>123.0</PayMin>
  <PayMax>123.0</PayMax>
  <EmploymentDurationType>ABC</EmploymentDurationType>
  <EmploymentType>ABC</EmploymentType>
  <Locations>
    <PositionLocation>
      <DistrictId>123</DistrictId>
    </PositionLocation>
    <PositionLocation>
      <DistrictId>123</DistrictId>
    </PositionLocation>
  </Locations>
  <PublishedState>ABC</PublishedState>
  <IsEntryLevel>false</IsEntryLevel>
  <IsWorkFromHome>false</IsWorkFromHome>
  <DraftId>ABC</DraftId>
</PositionSaveRequest>

Example JSON Request (switch to XML)

{
  "Title": "ABC",
  "PositionListings": [
    {
      "PositionListingId": 123,
      "ShortDescription": "ABC",
      "ReferenceId": "ABC",
      "PayAndBenefits": "ABC",
      "ContactDetails": {
        "ContactName": "ABC",
        "PreferredApplicationMethod": "ABC",
        "EmailAddress": "ABC",
        "ApplicationUrl": "ABC",
        "PhoneNumbers": [
          {
            "Prefix": "ABC",
            "Number": "ABC"
          },
          {
            "Prefix": "ABC",
            "Number": "ABC"
          }
        ]
      },
      "Descriptions": [
        {
          "Type": "ABC",
          "Text": "ABC"
        },
        {
          "Type": "ABC",
          "Text": "ABC"
        }
      ],
      "Promotions": {
        "BundleType": 0,
        "PromotionData": {
          "Branding": [
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            },
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            }
          ],
          "BulletPoints": [
            "ABC",
            "ABC"
          ]
        },
        "EnabledPromotions": [
          1,
          1
        ]
      },
      "PhotoIds": [
        123,
        123
      ],
      "VideoKey": "ABC",
      "SalaryOptIn": false
    },
    {
      "PositionListingId": 123,
      "ShortDescription": "ABC",
      "ReferenceId": "ABC",
      "PayAndBenefits": "ABC",
      "ContactDetails": {
        "ContactName": "ABC",
        "PreferredApplicationMethod": "ABC",
        "EmailAddress": "ABC",
        "ApplicationUrl": "ABC",
        "PhoneNumbers": [
          {
            "Prefix": "ABC",
            "Number": "ABC"
          },
          {
            "Prefix": "ABC",
            "Number": "ABC"
          }
        ]
      },
      "Descriptions": [
        {
          "Type": "ABC",
          "Text": "ABC"
        },
        {
          "Type": "ABC",
          "Text": "ABC"
        }
      ],
      "Promotions": {
        "BundleType": 0,
        "PromotionData": {
          "Branding": [
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            },
            {
              "BrandingId": 123,
              "BrandingType": "ABC"
            }
          ],
          "BulletPoints": [
            "ABC",
            "ABC"
          ]
        },
        "EnabledPromotions": [
          1,
          1
        ]
      },
      "PhotoIds": [
        123,
        123
      ],
      "VideoKey": "ABC",
      "SalaryOptIn": false
    }
  ],
  "PositionCompanyName": "ABC",
  "CategoryIds": [
    123,
    123
  ],
  "PayType": "ABC",
  "PayMin": 123.0,
  "PayMax": 123.0,
  "EmploymentDurationType": "ABC",
  "EmploymentType": "ABC",
  "Locations": [
    {
      "DistrictId": 123
    },
    {
      "DistrictId": 123
    }
  ],
  "PublishedState": "ABC",
  "IsEntryLevel": false,
  "IsWorkFromHome": false,
  "DraftId": "ABC"
}

Example XML Response (switch to JSON)

<PositionSaveResponse xmlns="http://api.trademe.co.nz/v1">
  <Position>
    <PositionId>123</PositionId>
    <PublishedState>ABC</PublishedState>
    <Title>ABC</Title>
    <DateCreated>2018-01-01T00:00:00Z</DateCreated>
    <DateModified>2018-01-01T00:00:00Z</DateModified>
    <DateArchived>2018-01-01T00:00:00Z</DateArchived>
    <HasLiveListing>false</HasLiveListing>
    <Listings>
      <PositionListingDetails>
        <PositionListingId>123</PositionListingId>
        <ListingId>123</ListingId>
        <StartDate>2018-01-01T00:00:00Z</StartDate>
        <EndDate>2018-01-01T00:00:00Z</EndDate>
        <IsLive>false</IsLive>
        <IsAccessible>false</IsAccessible>
        <ShortDescription>ABC</ShortDescription>
        <ReferenceId>ABC</ReferenceId>
        <PayAndBenefits>ABC</PayAndBenefits>
        <ContactDetails>
          <ContactName>ABC</ContactName>
          <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
          <EmailAddress>ABC</EmailAddress>
          <ApplicationUrl>ABC</ApplicationUrl>
          <PhoneNumbers>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
          </PhoneNumbers>
        </ContactDetails>
        <Descriptions>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
        </Descriptions>
        <Promotions>
          <BundleType>None</BundleType>
          <PromotionData>
            <Branding>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
            </Branding>
            <BulletPoints>
              <string>ABC</string>
              <string>ABC</string>
            </BulletPoints>
            <CandidateAccessQuota>123</CandidateAccessQuota>
          </PromotionData>
          <EnabledPromotions>
            <PromotionType>Featured</PromotionType>
            <PromotionType>Featured</PromotionType>
          </EnabledPromotions>
        </Promotions>
        <PhotoIds>
          <long>123</long>
          <long>123</long>
        </PhotoIds>
        <PhotoDetails>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
        </PhotoDetails>
        <Video>
          <VideoKey>ABC</VideoKey>
          <Thumbnails>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
          </Thumbnails>
        </Video>
        <SalaryOptIn>false</SalaryOptIn>
      </PositionListingDetails>
      <PositionListingDetails>
        <PositionListingId>123</PositionListingId>
        <ListingId>123</ListingId>
        <StartDate>2018-01-01T00:00:00Z</StartDate>
        <EndDate>2018-01-01T00:00:00Z</EndDate>
        <IsLive>false</IsLive>
        <IsAccessible>false</IsAccessible>
        <ShortDescription>ABC</ShortDescription>
        <ReferenceId>ABC</ReferenceId>
        <PayAndBenefits>ABC</PayAndBenefits>
        <ContactDetails>
          <ContactName>ABC</ContactName>
          <PreferredApplicationMethod>ABC</PreferredApplicationMethod>
          <EmailAddress>ABC</EmailAddress>
          <ApplicationUrl>ABC</ApplicationUrl>
          <PhoneNumbers>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
            <PhoneNumberDetails>
              <Prefix>ABC</Prefix>
              <Number>ABC</Number>
            </PhoneNumberDetails>
          </PhoneNumbers>
        </ContactDetails>
        <Descriptions>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
          <PositionListingDescription>
            <Type>ABC</Type>
            <Text>ABC</Text>
          </PositionListingDescription>
        </Descriptions>
        <Promotions>
          <BundleType>None</BundleType>
          <PromotionData>
            <Branding>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
              <PromotionBrandingItem>
                <BrandingId>123</BrandingId>
                <BrandingType>ABC</BrandingType>
                <BrandingUri>ABC</BrandingUri>
                <IsDeleted>false</IsDeleted>
              </PromotionBrandingItem>
            </Branding>
            <BulletPoints>
              <string>ABC</string>
              <string>ABC</string>
            </BulletPoints>
            <CandidateAccessQuota>123</CandidateAccessQuota>
          </PromotionData>
          <EnabledPromotions>
            <PromotionType>Featured</PromotionType>
            <PromotionType>Featured</PromotionType>
          </EnabledPromotions>
        </Promotions>
        <PhotoIds>
          <long>123</long>
          <long>123</long>
        </PhotoIds>
        <PhotoDetails>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
          <PositionListingPhotoDetail>
            <PhotoId>123</PhotoId>
            <Urls>
              <Thumbnail>ABC</Thumbnail>
              <List>ABC</List>
              <Medium>ABC</Medium>
              <Gallery>ABC</Gallery>
              <Large>ABC</Large>
              <FullSize>ABC</FullSize>
              <PlusSize>ABC</PlusSize>
            </Urls>
            <TransformData>
              <SourcePhotoDetails>
                <PhotoId>123</PhotoId>
                <Urls />
                <Dimensions>
                  <Width>123</Width>
                  <Height>123</Height>
                </Dimensions>
              </SourcePhotoDetails>
              <Rotation>123</Rotation>
              <Crop>
                <Min>
                  <X>123</X>
                  <Y>123</Y>
                </Min>
                <Max />
              </Crop>
            </TransformData>
            <Dimensions />
          </PositionListingPhotoDetail>
        </PhotoDetails>
        <Video>
          <VideoKey>ABC</VideoKey>
          <Thumbnails>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
            <PositionListingVideoThumbnail>
              <Url>ABC</Url>
              <Size>ABC</Size>
              <Width>123</Width>
              <Height>123</Height>
            </PositionListingVideoThumbnail>
          </Thumbnails>
        </Video>
        <SalaryOptIn>false</SalaryOptIn>
      </PositionListingDetails>
    </Listings>
    <OwnerCompanyId>123</OwnerCompanyId>
    <PositionCompanyName>ABC</PositionCompanyName>
    <CategoryIds>
      <int>123</int>
      <int>123</int>
    </CategoryIds>
    <PayType>ABC</PayType>
    <PayMin>123.0</PayMin>
    <PayMax>123.0</PayMax>
    <EmploymentDurationType>ABC</EmploymentDurationType>
    <EmploymentType>ABC</EmploymentType>
    <Self>
      <Href>ABC</Href>
      <Rel>ABC</Rel>
      <Prompt>ABC</Prompt>
      <Method>ABC</Method>
    </Self>
    <Locations>
      <PositionLocation>
        <DistrictId>123</DistrictId>
      </PositionLocation>
      <PositionLocation>
        <DistrictId>123</DistrictId>
      </PositionLocation>
    </Locations>
    <IsEntryLevel>false</IsEntryLevel>
    <IsWorkFromHome>false</IsWorkFromHome>
  </Position>
  <FeeSummary>
    <TotalCost>123.0</TotalCost>
    <TotalCostGstExcluded>123.0</TotalCostGstExcluded>
    <InsufficientBalance>false</InsufficientBalance>
    <MinimumRequiredTopUpAmount>123.0</MinimumRequiredTopUpAmount>
    <FeeItems>
      <FeeItem>
        <Type>ABC</Type>
        <Amount>123.0</Amount>
        <AmountGstExcluded>123.0</AmountGstExcluded>
        <WillBeInvoiced>false</WillBeInvoiced>
        <ProvidingSource>
          <Name>ABC</Name>
          <Remaining>123</Remaining>
          <IsUnlimited>false</IsUnlimited>
        </ProvidingSource>
      </FeeItem>
      <FeeItem>
        <Type>ABC</Type>
        <Amount>123.0</Amount>
        <AmountGstExcluded>123.0</AmountGstExcluded>
        <WillBeInvoiced>false</WillBeInvoiced>
        <ProvidingSource>
          <Name>ABC</Name>
          <Remaining>123</Remaining>
          <IsUnlimited>false</IsUnlimited>
        </ProvidingSource>
      </FeeItem>
    </FeeItems>
  </FeeSummary>
</PositionSaveResponse>

Example JSON Response (switch to XML)

{
  "Position": {
    "PositionId": 123,
    "PublishedState": "ABC",
    "Title": "ABC",
    "DateCreated": "\/Date(1514764800)\/",
    "DateModified": "\/Date(1514764800)\/",
    "DateArchived": "\/Date(1514764800)\/",
    "HasLiveListing": false,
    "Listings": [
      {
        "PositionListingId": 123,
        "ListingId": 123,
        "StartDate": "\/Date(1514764800)\/",
        "EndDate": "\/Date(1514764800)\/",
        "IsLive": false,
        "IsAccessible": false,
        "ShortDescription": "ABC",
        "ReferenceId": "ABC",
        "PayAndBenefits": "ABC",
        "ContactDetails": {
          "ContactName": "ABC",
          "PreferredApplicationMethod": "ABC",
          "EmailAddress": "ABC",
          "ApplicationUrl": "ABC",
          "PhoneNumbers": [
            {
              "Prefix": "ABC",
              "Number": "ABC"
            },
            {
              "Prefix": "ABC",
              "Number": "ABC"
            }
          ]
        },
        "Descriptions": [
          {
            "Type": "ABC",
            "Text": "ABC"
          },
          {
            "Type": "ABC",
            "Text": "ABC"
          }
        ],
        "Promotions": {
          "BundleType": 0,
          "PromotionData": {
            "Branding": [
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              },
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              }
            ],
            "BulletPoints": [
              "ABC",
              "ABC"
            ],
            "CandidateAccessQuota": 123
          },
          "EnabledPromotions": [
            1,
            1
          ]
        },
        "PhotoIds": [
          123,
          123
        ],
        "PhotoDetails": [
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          },
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          }
        ],
        "Video": {
          "VideoKey": "ABC",
          "Thumbnails": [
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            },
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            }
          ]
        },
        "SalaryOptIn": false
      },
      {
        "PositionListingId": 123,
        "ListingId": 123,
        "StartDate": "\/Date(1514764800)\/",
        "EndDate": "\/Date(1514764800)\/",
        "IsLive": false,
        "IsAccessible": false,
        "ShortDescription": "ABC",
        "ReferenceId": "ABC",
        "PayAndBenefits": "ABC",
        "ContactDetails": {
          "ContactName": "ABC",
          "PreferredApplicationMethod": "ABC",
          "EmailAddress": "ABC",
          "ApplicationUrl": "ABC",
          "PhoneNumbers": [
            {
              "Prefix": "ABC",
              "Number": "ABC"
            },
            {
              "Prefix": "ABC",
              "Number": "ABC"
            }
          ]
        },
        "Descriptions": [
          {
            "Type": "ABC",
            "Text": "ABC"
          },
          {
            "Type": "ABC",
            "Text": "ABC"
          }
        ],
        "Promotions": {
          "BundleType": 0,
          "PromotionData": {
            "Branding": [
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              },
              {
                "BrandingId": 123,
                "BrandingType": "ABC",
                "BrandingUri": "ABC",
                "IsDeleted": false
              }
            ],
            "BulletPoints": [
              "ABC",
              "ABC"
            ],
            "CandidateAccessQuota": 123
          },
          "EnabledPromotions": [
            1,
            1
          ]
        },
        "PhotoIds": [
          123,
          123
        ],
        "PhotoDetails": [
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          },
          {
            "PhotoId": 123,
            "Urls": {
              "Thumbnail": "ABC",
              "List": "ABC",
              "Medium": "ABC",
              "Gallery": "ABC",
              "Large": "ABC",
              "FullSize": "ABC",
              "PlusSize": "ABC"
            },
            "TransformData": {
              "SourcePhotoDetails": {
                "PhotoId": 123,
                "Urls": {
                },
                "Dimensions": {
                  "Width": 123,
                  "Height": 123
                }
              },
              "Rotation": 123,
              "Crop": {
                "Min": {
                  "X": 123,
                  "Y": 123
                },
                "Max": {
                }
              }
            },
            "Dimensions": {
            }
          }
        ],
        "Video": {
          "VideoKey": "ABC",
          "Thumbnails": [
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            },
            {
              "Url": "ABC",
              "Size": "ABC",
              "Width": 123,
              "Height": 123
            }
          ]
        },
        "SalaryOptIn": false
      }
    ],
    "OwnerCompanyId": 123,
    "PositionCompanyName": "ABC",
    "CategoryIds": [
      123,
      123
    ],
    "PayType": "ABC",
    "PayMin": 123.0,
    "PayMax": 123.0,
    "EmploymentDurationType": "ABC",
    "EmploymentType": "ABC",
    "Self": {
      "Href": "ABC",
      "Rel": "ABC",
      "Prompt": "ABC",
      "Method": "ABC"
    },
    "Locations": [
      {
        "DistrictId": 123
      },
      {
        "DistrictId": 123
      }
    ],
    "IsEntryLevel": false,
    "IsWorkFromHome": false
  },
  "FeeSummary": {
    "TotalCost": 123.0,
    "TotalCostGstExcluded": 123.0,
    "InsufficientBalance": false,
    "MinimumRequiredTopUpAmount": 123.0,
    "FeeItems": [
      {
        "Type": "ABC",
        "Amount": 123.0,
        "AmountGstExcluded": 123.0,
        "WillBeInvoiced": false,
        "ProvidingSource": {
          "Name": "ABC",
          "Remaining": 123,
          "IsUnlimited": false
        }
      },
      {
        "Type": "ABC",
        "Amount": 123.0,
        "AmountGstExcluded": 123.0,
        "WillBeInvoiced": false,
        "ProvidingSource": {
          "Name": "ABC",
          "Remaining": 123,
          "IsUnlimited": false
        }
      }
    ]
  }
}