Start
/
API-Referenz
/
API-Dokumentation (XML/ JSON)
/
Auftragstypen
/
Contact-Auftragstypen

Contact Create

API-Referenz (XML/JSON) · Aktualisiert 2026-04-09

Funktion

Der Auftragstyp ContactCreate legt einen neuen Kontakt an.

Beschreibung

Wenn Sie aus verwaltungstechnischen Gründen einen Kontakt mit gleichem Namen mehrmals benötigen, muss dies im Request angegeben werden.
In XML müssen Sie den Key <key>force_handle_create</key> unterhalb von <task> einfügen.
In JSON müssen Sie die Route folgendermaßen ergänzen /contact?keys[]=force_handle_create

Datenvalidierung

Die Adressdaten werden beim Anlegen des Kontakts validiert. Das Ergebnis der Validierung wird in den Kontaktdaten gespeichert.

Die Validierung ergibt Werte von A bis E. Liegt das Validierungsergebnis bei D oder E, schlägt das Anlegen des Kontakts mit dem Fehlercode EF01152 fehl. Es ist möglich, das Validierungsergebnis zu ignorieren und den Kontakt trotzdem anzulegen.

Dazu kann der Key ignoreAddressQuality über den Abfrageparameter „keys[] angegeben werden .

Route: POST /contact

{
   "alias": "petermuster",
   "type": "PERSON",
   "organization": "Company",
   "title": "Dr.",
   "city": "Musterstadt",
   "country": "DE",
   "state": "BY",
   "email": "petermuster@example.com",
   "fname": "Peter",
   "lname": "Muster",
   "address": [
      "123 Musterstrasse"
   ],
   "pcode": "12345",
   "phone": "+49-123-12345",
   "fax": "+49-123-12345"
}

{
    "stid": "20190628-app3-dev-11529",
    "status": {
        "code": "S0301",
        "text": "Domain-Kontakt wurde erfolgreich angelegt.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23151437"
    },
    "data": [
        {
            "created": "2019-06-28T14:52:48.000+0200",
            "updated": "2019-06-28T14:52:48.000+0200",
            "id": 23151437,
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "updater": {
                "context": 4,
                "user": "customer"
            },
            "alias": "petermuster",
            "type": "PERSON",
            "organization": "Company",
            "title": "Dr.",
            "city": "Musterstadt",
            "country": "DE",
            "state": "BY",
            "email": "petermuster@example.com",
            "protection": "SHOW_NONE",
            "fname": "Peter",
            "lname": "Muster",
            "address": [
                "Musterstrasse"
            ],
            "pcode": "12345",
            "phone": "+49-123-12345",
            "fax": "+49-123-12345"
        }
    ]
}

Auftragstyp-Code: 0301
Verwendet Objekt Contact

<request>
    <auth>
        <user>customer</user>
        <password>password</password>
        <context>4</context>
    </auth>
    <task>
        <code>0301</code>
        <handle>
            <alias></alias>
            <type>PERSON</type>
            <fname>Peter</fname>
            <lname>Muster</lname>
            <organization>PDA</organization>
            <address>Musterstrasse</address>
            <pcode>12345</pcode>
            <city>Musterstadt</city>
            <state>BY</state>
            <country>DE</country>
            <phone>+49-12345-12345</phone>
            <fax>+49-12345-12345</fax>
            <email>Muster@example.com</email>
            <protection>B</protection>
            <nic_ref>de</nic_ref>
            <extension>
                <idnumber>T22000129</idnumber>
            </extension>
        </handle>
        <reply_to>customer@example.com</reply_to>
    </task>
</request>

<response>
	<result>
		<status>
			<code>N0301</code>
			<text>Das Anlegen des Domain-Kontaktes wurde gestartet.</text>
			<text></text>
			<type>notify</type>
			<object>
				<type>handle</type>
				<value>9926612</value>
			</object>
		</status>
	</result>
</response>