This method creates a contact adress for an ImmobilienScout24 user.{username}/contact/


  • The telephone numbers can be entered in three separate parts (country code, area code (Ortsvorwahl) and telephone number) or as single input field but with the same seperate field restrictions!
  • Field restrictions:
  •     Country code (Ländervorwahl):  „00“ ist not allowed, it needs to be „+"
  •     Area code (Regionvorwahl): if Countrycode = "+49", than we disallow an area code which starts with „0"
  •     Spaces are the only valid divider within these fields.
  • These fields are mandatory, although they can be optional in the schema: last name and email.
  • Duplicate check (POST/PUT Contact) compares the following fields: salutation, first name, last name, street, housenumber, zip, city, country code, phone, fax, cell phone, homepage, email
  • The fields "officeHours" and "company" are no more used in the IS24 website
  • only 20 contacts with "showOnProfilePage" could be have the value "true"
  • External id which contains "/" needs to be url encoded

Supported media types

  • XML (Accept: application/xml)
  • JSON (Accept: application/json)

Authorization requirements

A System Key and an authenticated user are required for this operation:


Please use a secure connection (https) for this operation.


  • Username: the username which the user uses for logging in to www.immobilienscout24.
  • Username: "me" can be used instead of the username, when the user is logged in by 3-legged oauth.

Query Parameters




minimum xml


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<common:realtorContactDetail xmlns:common="" xmlns:xlink="" xmlns:ns4="" xmlns:ns5="" >


maximum xml


<?xml version="1.0" encoding="UTF-8"?>
<common:realtorContactDetail xmlns:common="" xmlns:xlink="" xmlns:ns4="" xmlns:ns5="" >
    <company>Immobilienscout24, field is no more used or visible in the is24 website</company>
    <position>position oder taetigkeit im unternehmen</position>
    <officeHours>Von 11:30 bis 12:00, dabei eine halbe Stunde Pause, field is no more used or visible in the is24 website</officeHours>


2nd option to send numbers (instead of the three seperate fields):

<faxNumber>+49 30 12345</faxNumber>
<phoneNumber>+49 30 54321</phoneNumber>
<cellPhoneNumber>+49 172 1234567</cellPhoneNumber>

Note: a given complete number (phoneNumber, faxNumber, cellPhoneNumber) is only considered if no corresponding number part (...CountryCode, ...AreaCode, ...Subscriber) is given.


  "common.realtorContactDetail" : {
    "email" : "",
    "salutation" : "MALE",
    "firstname" : "Max",
    "lastname" : "Mustermann",
    "phoneNumberCountryCode" : "+49",
    "phoneNumberAreaCode" : "30",
    "phoneNumberSubscriber" : "243010000",
    "cellPhoneNumberCountryCode" : "+49" ,
    "cellPhoneNumberAreaCode" : "152",
    "cellPhoneNumberSubscriber": "123123" ,
    "address" : {
      "street" : "Andreasstr.",
      "houseNumber" : "10",
      "postcode" : "10243",
      "city" : "Berlin"
    "countryCode" : "DEU",
    "title" : "Dr.",
    "additionName" : "HuiBuh" ,
    "company" : "Immobilienscout24, field is no more used or visible in the is24 website" ,
    "homepageUrl" : "" ,
    "position":"position oder taetigkeit im unternehmen",
    "officeHours" : "Von  11:30 bis 12:00, dabei eine halbe Stunde Pause, field is no more used or visible in the is24 website" ,
    "defaultContact" : false,
    "localPartnerContact" : false,
    "businessCardContact" : false,
    "realEstateReferenceCount" : 1,
    "externalId" : "fremdID",


The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.
Error responses as well as other simple message responses are described in detail within the common message responses.


Status 201 Created

This status code is returned after a new entity of a resource was successfully created.


Location Link to the newly created resource.




<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <common:messages xmlns:ns2="" xmlns:common="" xmlns:xlink="">
       <message>Resource [contact] with id [123456] has been created.</message>







    "common:messages": {
        "message": {
            "messageCode": "MESSAGE_RESOURCE_CREATED",
            "message": "Resource [contact] with id [123456] has been created.",
            "id": "123456"