---
title: "Contact Create"
url: "https://help.internetx.com/de/api/core-contact-create/"
lang: "de"
section: "API-Referenz — API-Referenz (XML/JSON)"
breadcrumb: "API-Dokumentation (XML/ JSON) > Auftragstypen > Contact-Auftragstypen"
updated: "2026-04-09"
---

# Contact Create

## 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](/de/api/core-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>
```