> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/integrationen/overview/integrations/contentful.md).

# Contentful

Integriere deinen Workflow mit Contentful

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-696c2b7d3b7c70c7f042236dcf0a7d5e51d5bff2%2Fcontentful-step-01-actions.png?alt=media" alt="Contentful Integration step with the Action dropdown listing Create Entry, Create Entry (JSON), List Entries, Get Entry, and Update Entry (JSON)"><figcaption><p>Wählen Sie eine Contentful-Aktion aus.</p></figcaption></figure>

Die Contentful-Integration ermöglicht es Ihnen, Einträge zu erstellen, aufzulisten, abzurufen und zu aktualisieren.

## Authentifizierung

1. **Generieren Sie einen Personal Access Token in Contentful:**
   * Melden Sie sich bei Ihrem Contentful-Konto an.
   * Navigieren Sie zu den Einstellungen und klicken Sie dann auf "CMA Tokens".
   * Klicken Sie auf die Schaltfläche "Create Personal Access To".
   * Geben Sie dem Token einen aussagekräftigen Namen, damit sein Verwendungszweck leicht erkennbar ist.
   * Nachdem der Token generiert wurde, stellen Sie sicher, dass Sie ihn sofort kopieren und sicher speichern, da er nicht erneut angezeigt wird.
2. **Fügen Sie den Personal Access Token zu Ihrem Arbeitsbereich hinzu:**
   * Gehen Sie zu <https://app.airops.com/account/integrations>
   * Suchen Sie den Abschnitt für die Contentful-Integration und klicken Sie auf die Schaltfläche "Configure".
   * Fügen Sie im angezeigten Modal den kopierten Personal Access Token in das vorgesehene Feld ein.
   * Für eine Authentifizierung mit Vollzugriff können Sie außerdem einen optionalen **Space-ID** eingeben, um ihn mit der Verbindung zu speichern.
   * Für eine Authentifizierung mit Vollzugriff klicken Sie auf **Verbindung testen**, überprüfen Sie die Ergebnisse und dann **Integration speichern**. Das Testen umfasst die Space-ID, wenn konfiguriert. Siehe [Eine Verbindung testen](https://docs.airops.com/docs/de/dein-workspace/settings/authentications.md#test-a-connection) für Details zu den Ergebnissen.

**Sicherheitshinweis:** Behandeln Sie Ihren Personal Access Token wie ein Passwort. Er gewährt vollen Zugriff auf Ihren Contentful-Space und sollte nicht weitergegeben werden. Bewahren Sie ihn sicher auf und verwenden Sie ihn nur in serverseitigen oder sicheren, authentifizierten Umgebungen.

## Funktionen und ihre Parameter

#### Eintrag erstellen

1. **Space**: Wählen Sie einen Contentful-Space aus.
2. **Umgebung**: Wählen Sie eine Contentful-Umgebung aus
3. **Inhaltstyp**: Wählen Sie einen Contentful-Inhaltstyp aus
4. **Gebietsschema (optional)**: Inhaltssprache. Standardmäßig en-US

* Nachdem Sie den Inhaltstyp ausgewählt haben, werden je nach gewählter Option neue Felder angezeigt.

#### Eintrag erstellen (JSON)

1. **Space-ID**: Die ID Ihres Contentful-Spaces, z. B. yadj1kx9rmg0
2. **Umgebung**: Der Name Ihrer Umgebung. Das ist normalerweise master
3. **Inhaltstyp-ID**
4. **JSON**: Ein JSON-Objekt, das die Felder für Ihren Eintrag enthält, Beispiel:

```
{
   "fields": {
      "title": {
         "en-US": "Hallo, Welt!"
      },
      "body": {
         "en-US": "Ist Bacon gesund?"
      }
   }
}
```

#### Einträge auflisten

1. **Space-ID**: Die ID Ihres Contentful-Spaces, z. B. yadj1kx9rmg0
2. **Umgebung**: Der Name Ihrer Umgebung. Das ist normalerweise master
3. **Begrenzung (optional)**: Wie viele Einträge abgerufen werden sollen.
4. **Überspringen (optional)**: Wie viele Einträge beim Abrufen der Antwort zuerst übersprungen werden sollen.

#### Eintrag abrufen

1. **Space-ID**: Die ID Ihres Contentful-Spaces, z. B. yadj1kx9rmg0
2. **Umgebung**: Der Name Ihrer Umgebung. Das ist normalerweise master
3. **Eintrags-ID**: Die ID oder der Slug des Eintrags, den Sie abrufen möchten
4. **Gebietsschema (optional)**: Inhaltssprache. Standardmäßig en-US

#### Eintrag aktualisieren (JSON)

1. **Space-ID**: Die ID Ihres Contentful-Spaces, z. B. yadj1kx9rmg0
2. **Umgebung**: Der Name Ihrer Umgebung. Das ist normalerweise master
3. **Inhaltstyp-ID**: Die ID des Inhaltstyps, den Sie erstellen werden.
4. **Eintrags-ID**: Die ID des Eintrags, den Sie aktualisieren möchten
5. **JSON**: Ein JSON-Objekt, das die zu aktualisierenden Felder enthält, Beispiel:

```
{
   "title": {
      "en-US": "Hallo, Welt!"
   },
   "body": {
      "en-US": "Bacon ist gesund!"
   }
}
```

#### Bild hochladen

1. **Space-ID**: Die ID Ihres Contentful-Spaces, z. B. yadj1kx9rmg0
2. **Umgebung**: Der Name Ihrer Umgebung. Das ist normalerweise master
3. **Bild-URL**
4. **Titel (optional)**
5. **Beschreibung (optional)**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/de/integrationen/overview/integrations/contentful.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
