---
title: "Verwaltetes Kundenkonto bereitstellen"
description: "Erstellen Sie ohne Kundenregistrierung ein isoliertes CloudPrint-Konto, eine App Installation und ein einmaliges Agent Enrollment."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Verwaltetes Kundenkonto bereitstellen

<p class="docs-lead">Erstellen Sie ohne Kundenregistrierung ein isoliertes CloudPrint-Konto, eine App Installation und ein einmaliges Agent Enrollment.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-post">POST</span><code>/partner-api/v1/accounts</code><span><strong>API-Version:</strong> v1</span><span><strong>operationId:</strong> <code>createPartnerManagedAccount</code></span><a href="/de/docs/api/v1/partner/accounts/create/index.md">Als Markdown anzeigen</a></div>

## Funktion dieser Methode

Erstellen Sie ohne Kundenregistrierung ein isoliertes CloudPrint-Konto, eine App Installation und ein einmaliges Agent Enrollment.

## Authentifizierung

Senden Sie eine einmalige RS256-Assertion der Developer Application in `Authorization: Bearer <application_assertion>`. Sie ist kein Public-API-Zugriffstoken.

## Anfrage

**Produktions-URL:** `https://public-api.cloudprint.me/partner-api/v1/accounts`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `Idempotency-Key` | header | `string` | ja | Stabiler, vom Client erzeugter Schlüssel, damit Wiederholungen das ursprüngliche Ergebnis liefern und kein Duplikat erstellen. | minLength: 1; maxLength: 200 |
| `X-Request-Id` | header | `string` | nein | Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück. | maxLength: 128; example: `"order-100045-attempt-1"` |

### Anfrageinhalt

**Inhaltstyp:** `application/json`

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `external_customer_id` | `string` | ja | Stabile Kennung, die der Integrator dem Kunden im eigenen System zuordnet. | minLength: 1; maxLength: 160; example: `"customer-42"` |
| `name` | `string` | ja | Anzeigename der Ressource für die Kontobetreiber. | minLength: 1; maxLength: 120; example: `"Acme Store 42"` |
| `permissions` | `array` | nein | Für die App Installation genehmigte Berechtigungen. | — |
| `agent_onboarding` | `object` | ja | Einmalige Verbindungsdaten für den Agenten des verwalteten Kunden. | — |

### Anfragebeispiele

#### cURL

```bash
curl -sS https://public-api.cloudprint.me/partner-api/v1/accounts \
  -H "Authorization: Bearer $APPLICATION_ASSERTION" \
  -H 'Idempotency-Key: customer-42-provision-v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "external_customer_id": "customer-42",
    "name": "Acme Store 42",
    "permissions": ["printers:read", "documents:write", "print_jobs:write", "print_jobs:read"],
    "agent_onboarding": {
      "return_uri": "https://app.integrator.example/cloudprint/callback",
      "state": "single-use-random-state"
    }
  }'
```

## Antwort

**HTTP-Status:** `200` — Anfrage erfolgreich.

### Antwortfelder

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `relationship_id` | `string (uuid)` | ja | Stabile UUID der Beziehung zwischen Partner und verwaltetem Kunden. | — |
| `developer_account_id` | `string (uuid)` | ja | Stabile UUID des Entwicklerkontos, dem die Kundenbeziehung gehört. | — |
| `cloudprint_account_id` | `string (uuid)` | ja | Stabile UUID des CloudPrint-Kontos für den verwalteten Kunden. | — |
| `external_customer_id` | `string` | ja | Stabile Kennung, die der Integrator dem Kunden im eigenen System zuordnet. | maxLength: 160 |
| `name` | `string` | ja | Anzeigename der Ressource für die Kontobetreiber. | maxLength: 120 |
| `application_id` | `string (uuid)` | ja | Stabile Kennung der Developer Application, die mit der Ressource verknüpft ist. | — |
| `installation_id` | `string \| null (uuid)` | ja | Stabile UUID der App Installation, die mit der Ressource verknüpft ist. | — |
| `agent_enrollment_id` | `string \| null (uuid)` | ja | Stabile Kennung des Agent Enrollments. | — |
| `agent_onboarding_expires_at` | `string \| null (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |
| `agent_onboarding_url` | `string \| null (uri)` | ja | Kanonischer Einmal-Link zum Verbinden eines Agenten. Öffnen Sie ihn vollständig und unverändert und schreiben Sie ihn nicht in Protokolldateien. | example: `"https://connect.cloudprint.me/setup#token=cpat_example"` |
| `onboarding_status` | `string` | ja | Aktueller Bereitschaftsstatus der CloudPrint-Einrichtung des verwalteten Kunden. | enum: `provisioning`, `waiting_for_agent`, `ready`, `failed` |
| `status` | `string` | ja | Aktueller Ressourcen- oder Prozessstatus; verwenden Sie die Enum-Werte der jeweiligen Methode. | enum: `provisioning`, `active`, `suspended`, `closed` |
| `created_at` | `string (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |
| `updated_at` | `string (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |

### Beispielantwort

```json
{
  "relationship_id": "11111111-1111-4111-8111-111111111111",
  "developer_account_id": "11111111-1111-4111-8111-111111111111",
  "cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
  "external_customer_id": "string",
  "name": "string",
  "application_id": "11111111-1111-4111-8111-111111111111",
  "installation_id": "11111111-1111-4111-8111-111111111111",
  "agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
  "agent_onboarding_expires_at": "2026-08-06T12:00:00Z",
  "agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
  "onboarding_status": "provisioning",
  "status": "provisioning",
  "created_at": "2026-08-06T12:00:00Z",
  "updated_at": "2026-08-06T12:00:00Z"
}
```

## Fehler

| HTTP-Status | Beschreibung |
| --- | --- |
| `401` | Authentifizierung fehlt oder ist ungültig. |
| `403` | Das Token hat nicht die erforderlichen Berechtigungen. |
| `404` | Ressource nicht gefunden. |
| `409` | Die Anfrage widerspricht dem aktuellen Zustand. |
| `422` | Mindestens ein Feld ist ungültig. |
| `429` | Anfragelimit überschritten; beachten Sie Retry-After. |
| `500` | Interner CloudPrint-Fehler. |

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/partner/accounts/list/"><strong>Verwaltete Kundenkonten auflisten</strong><span>Rufen Sie die von der authentifizierten Partneranwendung bereitgestellten Kundenkonten einschließlich Agent- und Druckerstatus ab.</span></a>
<a class="docs-card" href="/de/docs/api/v1/partner/agent-enrollments/create/"><strong>Verwaltetes Agent Enrollment erstellen</strong><span>Stellen Sie vor oder nach dem Kunden-Onboarding ein idempotentes, einmaliges Enrollment aus.</span></a>
<a class="docs-card" href="/de/docs/api/v1/idempotency/"><strong>Idempotentes Erstellen von Druckaufträgen</strong><span>Verhindern Sie doppelte Ausdrucke, wenn Anfragen nach Timeout oder Netzwerkfehler wiederholt werden.</span></a></div>

<nav class="docs-resource-links" aria-label="Nächste Schritte"><a href="https://cloudprint.me/status/">Dienststatus</a><a href="/de/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Konto öffnen</a><a href="/docs/legal/privacy/">Datenschutzerklärung</a><a href="/docs/legal/terms/">Nutzungsbedingungen</a><a href="/docs/legal/payments-and-refunds/">Zahlungen und Erstattungen</a><a href="/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>