# create_inbox

Verhalten, Eingaben, Ausgaben und Freigaben für create_inbox.

Source: https://docs.getridian.com/de/developers/tools/create_inbox/
Language: de
Reviewed: 2026-10-06

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

## Verhalten und Grenzen

Legt eine Agent Mailbox auf der konfigurierten Ridian-Domain an. Benötigt inbox:manage, alle bestehenden und künftigen eigenen Postfächer in der Policy und einen freien Tarifplatz. Ein kostenloses Postfach pro Person über alle Workspaces; bezahlte Kontingente gelten je Workspace. Höchstens 20 erfolgreiche Erstellungen pro Person innerhalb rollierender 24 Stunden über alle Workspaces und Clients; Löschen setzt diese Grenze nicht zurück. localPart: 3–40 Kleinbuchstaben, Ziffern oder Bindestriche; reservierte/vergebene Adressen sind gesperrt. Liefert ID, vollständige Adresse und managementUrl für das Postfach in Ridian. Kein Agentlauf oder Versand. Bei unklarem Ergebnis vor erneutem Anlegen list_inboxes nutzen.

## Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

`inbox:manage`

[Freigaben und Grenzen](https://docs.getridian.com/de/developers/authentication/)

## Eingabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "localPart": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{2,39}$"
    }
  },
  "required": [
    "name",
    "localPart"
  ],
  "additionalProperties": false
}
```

## Ausgabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "address": {
      "type": "string"
    },
    "managementUrl": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "address",
    "managementUrl"
  ],
  "additionalProperties": false
}
```

## Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

[Fehlerbehandlung](https://docs.getridian.com/de/developers/errors/)