> For the complete documentation index, see [llms.txt](https://missiveapp.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://missiveapp.com/docs/developers/de/rest-api.md).

# Rest API

Verwenden Sie die Missive REST API, um Unterhaltungen anzureichern, Entwürfe zu automatisieren, Kontakte synchronisieren und mehr.

Die Missive-API ermöglicht es Ihnen, Missive-Unterhaltungen mit Inhalten aus dem gesamten Web anzureichern. Sie können außerdem Aufgaben automatisieren, etwa das Erstellen und Senden von Entwürfen, das Synchronisieren von Kontakten und mehr.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-d4c7502fa58585f3a1b3050bb1672f806ff44dd6%2Fpost%20demo%20837ff16f2134b2eb4887a40565599235342f710c7fcf8da425fc5afe91d554ca.png?alt=media" alt="Beispiel für einen mit der REST API erstellten Beitrag" width="563"></div>

z. B. eine Aktion in einer anderen App, die einen Beitrag in eine Unterhaltung einfügt.

#### Grundlagen

Die API ist eine Sammlung von Endpoints mit einer Methode (z. B. `POST`) und einer URL in der Form von:

```
https://public.missiveapp.com/v1/:endpoint_name
```

#### Authentifizierung

Um die API zu verwenden, müssen Sie zuerst Ihr API token abrufen. Rufen Sie es unter Persönliche Einstellungen in Missive ab, klicken Sie auf den **API** -Tab, dann auf den Link **Neues Token** .

{% hint style="info" %}
Sie müssen Teil einer Organisation sein, die den Productive plan abonniert hat, [Productive plan](https://missiveapp.com/pricing) um API tokens generieren zu können.
{% endhint %}

Sie müssen Ihr Token als `Bearer` Token im `Authorization` HTTP-Header senden.

{% code title="Beispielanfrage" %}

```http
POST /v1/drafts
Host: public.missiveapp.com
Authorization: Bearer missive_pat-26pApm_QTmyhLLbA...FwoFGmJ6x-6fikpQ
```

{% endcode %}

{% hint style="info" %}
Alle API tokens sind persönlich. Es gibt kein Token auf Organisationsebene und kein Token für ein bestimmtes geteiltes Konto. Ihr persönliches Token hat Zugriff auf jedes Konto, auf das Sie in Missive zugreifen können, einschließlich geteilter Konten. Verwenden Sie die Konto- oder Postfach-Parameter in Ihren Anfragen, um die Ergebnisse auf ein bestimmtes geteiltes Konto zu filtern.
{% endhint %}

#### Vorlagen

Alle API-Vorlagen sind als [JSON](http://www.json.org/)formatiert, einschließlich Fehlern. Erfolgreiche `POST` Anfragen können den [201](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) Statuscode ohne Body zurückgeben.

#### Vorlagen auswerten

Sie sollten den Erfolg Ihrer Anfragen aus dem zurückgegebenen HTTP-Statuscode ableiten. Eine erfolgreiche Anfrage gibt entweder einen [200](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) oder [201](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) Statuscode.

#### POST-Bodies

Sie müssen POST-Anfragen explizit mit `Content-Type: application/json`.

{% code title="POST-Beispiel" %}

```http
POST /v1/drafts
Host: public.missiveapp.com
Authorization: Bearer missive_pat-26pApm_QTmyhLLbA...FwoFGmJ6x-6fikpQ
Content-Type: application/json

{"drafts":{}}
```

{% endcode %}

#### Ressourcen-IDs

Um über die API mit Ressourcen zu interagieren, benötigen Sie die ID dieser Ressource. `ID`Wenn Sie beispielsweise beim Erstellen eines Beitrags einer Unterhaltung ein Label hinzufügen möchten, benötigen Sie die Label-ID. `ID`Sie können diese Ressourcen-IDs erhalten, indem Sie die API-Einstellungen öffnen und auf den Tab Ressourcen-IDs klicken.

<div data-with-frame="true"><img src="https://3895029528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FegxqkD7AXM4n11rNf5qI%2Fuploads%2Fgit-blob-df98688126a968a54a0aa12f7fe7b7040b2445a3%2Fresource%20ids%20f49af9ae85108c87a6db51903e6f25c86583020b057d5e415b8eeaaa528d243a.png?alt=media" alt="Ressourcen-IDs in Ihren API-Einstellungen finden"></div>

Einstellungen > API > Ressourcen-IDs

Zuletzt aktualisiert am 24. Februar 2020

<details>

<summary>Benötigen Sie genauere Antworten?</summary>

[Kontakt](https://missiveapp.com/docs/developers/de/contact.md)

</details>


---

# 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://missiveapp.com/docs/developers/de/rest-api.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.
