---
title: "Redirect Create"
url: "https://help.internetx.com/de/api/core-redirect-create/"
lang: "de"
section: "API-Referenz — API-Referenz (XML/JSON)"
breadcrumb: "API-Dokumentation (XML/ JSON) > Auftragstypen > Redirect-Auftragstypen"
updated: "2023-09-07"
---

# Redirect Create

## Funktion

Der Auftragstyp _RedirectCreate_ legt eine neue Weiterleitung für eine Domain oder E-Mail-Adresse an.

Die Weiterleitungen werden über einen eigenen Server vorgenommen (IP-Adresse 62.116.130.8). Parallel zu dem Eintrag in die Weiterleitungs-Verwaltung musst du die Domain und die gewünschten Subdomain-Einträge auf diese IP-Adresse umstellen. Betreibst du eigene Nameserver, musst du die IP-Adresse manuell auf deinen Nameservern eintragen.  
Möchtest du nur eine E-Mail-Weiterleitung ohne Web-Weiterleitung einrichten, musst du den MX der Quellen umstellen, damit er auf die IP-Adresse 62.116.130.8 verweist. Bitte ändere hierzu die IP-Adresse der als MX genutzten Subdomain. Beachte bei Domains die Groß- und Kleinschreibung. E-Mail-Adressen werden vom System automatisch in Kleinbuchstaben umgewandelt.

Beispiele

Eine Domain weiterleiten

_[example.com](http://example.com) => [example.de](http://example.de)_  
_[example.com](http://example.com) => [example.de](http://example.de) / subfolder / index.html_

E-Mail-Adressen weiterleiten

_[jane\_smith@example.com](mailto:jane_smith@example.com) => [jane@example.de](mailto:jane@example.de) (mode=single)_  
_@[example.com](http://example.com)\=> [jane@example.de](mailto:jane@example.de) (mode=catchall)_

## Beschreibung

Route: POST /redirect  

```
{
    "source": "example.com",
    "target": "example-target.com/test",
    "type": "DOMAIN",
    "mode": "HTTP"
}
```

```
{
    "stid": "20190701-app2-dev-15314",
    "status": {
        "code": "S0501",
        "text": "Weiterleitung wurde erfolgreich eingetragen.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Redirect",
        "summary": 1
    },
    "object": {
        "type": "Redirect",
        "value": "example.com",
        "data": {
            "created": "2014-10-24T09:43:47.000+0200",
            "updated": "2017-11-17T17:35:21.000+0100",
            "source": "example.com",
            "target": "example-target.de/test",
            "type": "DOMAIN",
            "mode": "HTTP",
            "domain": "example.com"
        }
    }
}
```

Auftragstyp-Code: 0501  
Verwendet Objekt [Redirect](/de/api/core-objekt-redirect/)

**Domain redirect, http-mode**

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>domain</type>
			<mode>http</mode>
			<source>www.source-example.com</source>
			<target>www.target-example.com</target>
		</redirect>
	</task>
</request>
```

```
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>
```

**Domain redirect, frame mode**

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>domain</type>
			<mode>frame</mode>
			<title>Redirection-Title</title>
			<source>www.source-example.com</source>
			<target>www.target-example.com</target>
			<backup>www.backup-target1.de</backup>
			<backup>www.backup-target2.de</backup>
			<backup>www.backup-target3.de</backup>
		</redirect>
	</task>
</request>
```

```
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>
```

**Email redirect single mode**

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>email</type>
			<mode>single</mode>
			<source>source@email-address.com</source>
			<target>target@email-address.com</target>
		</redirect>
	</task>
</request>
```

```
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>
```

**Email redirect catch-all mode**

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>email</type>
			<mode>catchall</mode>
			<source>@email-address.com</source>
			<target>target@email-address.com</target>
		</redirect>
	</task>
</request>
```

```
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>
```