> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration erstellen

> Erstelle eine neue benutzerdefinierte Integration in deinem Workspace

<Info>
  **Nutzt du unsere API über ein Dedicated Deployment?** Ersetze einfach `api.langdock.com` mit der Basis-URL deines Deployments: **`<deployment-url>/api/public`**
</Info>

Erstellt eine neue benutzerdefinierte Integration in deinem Workspace. Nach der Erstellung kannst du Actions und Triggers zur Integration hinzufügen.

## Erforderliche Scopes

Dieser Endpoint erfordert den `INTEGRATION_API` Scope.

## Request-Parameter

| Parameter     | Typ    | Erforderlich | Beschreibung                               |
| ------------- | ------ | ------------ | ------------------------------------------ |
| `name`        | string | Ja           | Integrationsname (max. 40 Zeichen)         |
| `description` | string | Nein         | Integrationsbeschreibung (max. 90 Zeichen) |

## Beispiel

```javascript theme={null}
const axios = require("axios");

async function createIntegration() {
  const response = await axios.post(
    "https://api.langdock.com/integrations/v1/create",
    {
      name: "My Custom Integration",
      description: "Connects to my internal company API for data retrieval"
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Created integration:", response.data.integration);
  return response.data.integration.id;
}

createIntegration();
```

## Antwortformat

### Erfolgreiche Antwort (201 Created)

```typescript theme={null}
{
  integration: {
    id: string;          // UUID der erstellten Integration
    name: string;        // Integrationsname
    description: string; // Integrationsbeschreibung
    createdAt: string;   // ISO 8601 Zeitstempel
  };
}
```

## Beispielantwort

```json theme={null}
{
  "integration": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My Custom Integration",
    "description": "Connects to my internal company API for data retrieval",
    "createdAt": "2025-02-18T10:30:00.000Z"
  }
}
```

## Fehlerbehandlung

| Status Code | Beschreibung                                              |
| ----------- | --------------------------------------------------------- |
| 400         | Ungültiger Request Body (Name zu lang, ungültige Zeichen) |
| 401         | Ungültiger oder fehlender API-Schlüssel                   |
| 429         | Rate Limit überschritten                                  |
| 500         | Interner Serverfehler                                     |

## Nächste Schritte

Nach dem Erstellen einer Integration wirst du typischerweise Folgendes tun:

1. [Actions hinzufügen](/de/developer/integrations-api/create-action), die Agents ausführen können
2. [Triggers hinzufügen](/de/developer/integrations-api/create-trigger), die Workflows oder Konversationen starten
3. [Authentifizierung konfigurieren](/de/developer/integrations-api/update-auth), falls deine Integration dies erfordert

<Info>
  Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu [Best Practices für API-Schlüssel](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>