PUT /vendor/jobs/postings/:id

This call allows you to update an existing posting in XING jobs. Please note that this call follows PATCH logic. You just have to submit those parameters you want to be changed. The GET parameter id is supposed to be the XING posting id of a posting you've created. The creation call returns this ID when successful. Find an example request at the very bottom.

Update restrictions

The organization_id and order_id parameters must not be changed. The parameters function and industry_id can only be updated within 24 hours after creating the posting.

Optional parameters

organization_id You'll get this unique IDs from your point of contact type in our sales department. It is mandatory to bill your job postings to the correct account.
order_id
function Title of the job posting. Length is limited to 255 characters.
company_name Name of the company advertising this job posting. Length is limited to 100 characters.
description The description of the posting. Allows you to add either plain text or basic HTML formatting. The following HTML tags are available:
h1, h2, h3, h4, h5, h6, hr, a, br, li, ol, ul, p, b, em, i, strong
Other tags and attributes including style tags and inline CSS will be removed. Length is limited to 10.000 characters.
city City of the job location. Please provide real and exact values only. For example, sending “Somecity (near Munich)” as city would be accepted by the API but may lead to problems with our geolocation search and, as a result, less traffic for your job posting on our search page. Multiple locations are not supported.
country Country of the job location. Please find available values here.
tags Comma separated list of keywords to improve the searchability of the posting. Length is limited to 500 characters.
reply_setting Defines how candidates can apply for this job posting. Possible values are:
  • email - requires parameter 'reply_email'
  • url - requires parameter 'reply_url'
  • private_message - requires parameter 'poster_url'
point_of_contact_type Defines who can be contacted for more information about this job posting. It will be shown right beneath the job posting. Possible values are:
  • user - requires parameter 'poster_url'
  • company - requires parameter 'company_profile_url'
  • none - if none is available
language Language of the job posting. Should be an ISO code like defined in ISO 639-1
job_type Type of this job posting. Must be one of:
  • FULL_TIME
  • PART_TIME
  • CONTRACTOR
  • INTERN
  • SEASONAL
  • TEMPORARY
  • VOLUNTARY
level Career level of the job posting. Please find available values here.
discipline_id Discipline ID of the job posting. Please find available values here.
industry_id Industry ID of the job posting. Please find available values here.
zipcode Zipcode, street and region of the job location. Use this along with mandatory parameters city and country to define the location more precisely.
street
region
skills Comma separated list of skills a candidate should have. This parameter used for recommendations and will not be shown in the job posting. Length is limited to 255 characters
reply_email Conditionally required Email address to apply. This is required if the reply_setting is set to `email`.
reply_url Conditionally required URL to an application form. This is required if the reply_setting is set to `url`.
poster_url Conditionally required URL to a XING user profile. Jobseekers applying will be able to send a private message to this user. This is required if the reply_setting is set to `user` or create_story_on_activation is set.
user_role Conditionally required In case the point_of_contact_type is 'user', this parameter is required and will describe the role of this user appearing next to the job posting. Possible values are:
  • EXTERNAL_RECRUITER
  • HR_DEPARTMENT
  • MANAGER
  • EMPLOYEE
  • HR_CONSULTANT
company_profile_url Conditionally required URL to a XING company profile. This is required if publish_to_company is set or point_of_contact_type is set to `company`. Please click here for further information
publish_to_company Boolean indicating whether the posting should be displayed on the company profile. Requires company_profile_url to define it. Default is false. Please click here for further information
create_story_on_activation Boolean indicating whether a stream story is published on the point of contact profile to inform his contacts about the new job. Requires poster_url to be set. Default is false
posting_url If you’d like to use full HTML, use this parameter to include a HTTPS URL to a job ad on your website which will then be shown in an iframe as a description of your job ad. Please click here for further information
posting_pdf_content Base64 encoded pdf file for orders which allow pdfs. PDF maximum size of 2 MB in DIN A4 format. This feature can only be used with Professional / Professional+ postings and not along with a posting_url
posting_logo_content Base64 encoded logo image for Standard and Campus postings. Maximum image size is 1 MB. Please click here for further information
job_code A free text job code / ID. It is not shown on the job posting and can be used to identify your postings in our GET calls or for billing reasons. Length is limited to 100 characters
salary The salary can be defined by either a single value (salary) OR as range by providing a lower boundary and a higher one. You can’t submit a single value and a range at the same time. Provide all this fields as integer numbers without any formatting. Please click here for further information
salary_range_start
salary_range_end
salary_interval The interval in which the salary or salary range is defined. Possible values are:
  • yearly (default)
  • monthly
  • weekly
  • hourly
currency The currency of the salary. Possible values are:
  • EUR (default)
  • CHF
  • CNY
  • DKK
  • BRL
  • GBP
  • HUF
  • JPY
  • KPW
  • KRW
  • PLN
  • RON
  • RUB
  • SEK
  • TRY
  • USD
tell_me_more Boolean indicating whether the "I'm Interested" button is shown on the job posting. It requires the point_of_contact_type to be 'user' and the poster_url to be set. Default is false. Please click here for further information
student_classification Conditionally required This is required for Campus job postings and classifies them.
Please find available values here
video_link Video link from Vimeo or YouTube. Video will be included below the job posting content. Only available for Professional+ postings

Example request

The following curl example shows a simple request on how to update a job posting on XING jobs:

curl -X PUT "https://api.xing.com/vendor/jobs/postings/30675491" \
-d "oauth_token=$ACCESS_TOKEN"                                    \
-d "oauth_consumer_key=$CONSUMER_KEY"                             \
-d "oauth_signature_method=PLAINTEXT"                             \
-d "oauth_signature=$CONSUMER_SECRET%26$ACCESS_TOKEN_SECRET"      \
-d '{
      "function": "Technical Product Manager - Jobs Integration (m/w)"
    }'

Example response

HTTP/1.1 204 No Content