REST APIGET

Posteingang-Übersicht

Sehen Sie ungelesene Kommentare, Erwähnungen, Nachrichten und Bewertungen Ihrer Konten, welche Posteingang-Kanäle jedes Konto nutzen kann, und fordern Sie einen neuen Lesevorgang an.

Der Posteingang sammelt vier Kanäle aus den verbundenen Konten: Kommentare zu Ihren Beiträgen, Erwähnungen Ihrer Konten in Beiträgen anderer, Direktnachrichten und Bewertungen aus Google Business Profile. TikTok und X haben keinen Posteingang.

GEThttps://post.adaptlypost.com/post/api/v1/inbox/summary

Gibt die Zahl der ungelesenen Einträge pro Kanal zurück und pro verbundenem Konto, welche Kanäle es nutzen kann und wann es zuletzt gelesen wurde.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.readRollen und Berechtigungen

Jede Rolle hat inbox.read, daher kann jeder gültige Schlüssel den Posteingang lesen.

Etwa 10 Minuten, nicht in Echtzeit

AdaptlyPost liest jedes verbundene Konto alle 10 Minuten und speichert, was es findet. Die Listen antworten aus dieser Kopie, daher erscheint ein neuer Kommentar, eine Erwähnung, Nachricht oder Bewertung innerhalb von etwa 10 Minuten. POST /api/v1/inbox/refresh fordert sofort einen Lesevorgang an. Webhook-Ereignisse stammen aus denselben Lesevorgängen.

Kanäle, die eine neue Verbindung brauchen

Jeder Kanal ist über die API erreichbar. Fehlt einer Verbindung die Plattform-Berechtigung für einen Kanal oder eine Aktion, auch eine, die die Plattform für AdaptlyPost noch prüft, zeigt GET /api/v1/inbox/summary den Kanal als RECONNECT_REQUIRED, und jeder Schreibzugriff darauf antwortet mit 403 inbox_reconnect_required. Ein abgelaufenes Token antwortet genauso. Bitten Sie die Person, das Konto in AdaptlyPost neu zu verbinden; ein erneuter Versuch hilft nicht.

Unterstützte Plattformen

Welchen Kanal jede Plattform hat. Ein Konto erhält nur einen Kanal, für den seine Verbindung die Berechtigung hat; die Übersicht zeigt es pro Konto.

Plattform	Kommentare	Erwähnungen	Nachrichten	Bewertungen
`FACEBOOK`	Ja	Ja	Ja	Nein
`INSTAGRAM`	Ja	Nur lesen, für über Facebook verbundene Konten	Ja	Nein
`THREADS`	Ja	Ja	Nein	Nein
`YOUTUBE`	Ja	Nein	Nein	Nein
`LINKEDIN`	Nur Unternehmensseiten	Nein	Nein	Nein
`BLUESKY`	Ja	Ja	Ja	Nein
`MASTODON`	Ja	Ja	Ja	Nein
`GOOGLE_BUSINESS`	Nein	Nein	Nein	Ja

Felder der Übersicht

Feld	Beschreibung
`unread`	UNREAD-Einträge pro Kanal: comments, mentions, conversations und reviews
`accounts[].accountId`	Die id des Kontos aus GET /social-accounts, mit platform, accountName und avatarUrl
`accounts[].needsReconnect`	True, wenn das Konto neu verbunden werden muss, bevor seine Kommentare gelesen werden können
`accounts[].lastSyncedAt`	Wann AdaptlyPost das Konto zuletzt gelesen hat, oder null vor dem ersten Lesevorgang
`accounts[].lastErrorCode`	Warum der letzte Lesevorgang fehlgeschlagen ist, oder null
`accounts[].comments`	AVAILABLE, RECONNECT_REQUIRED oder UNSUPPORTED für diesen Kanal. Siehe unten
`accounts[].mentions`	AVAILABLE, RECONNECT_REQUIRED oder UNSUPPORTED für diesen Kanal. Siehe unten
`accounts[].messages`	AVAILABLE, RECONNECT_REQUIRED oder UNSUPPORTED für diesen Kanal. Siehe unten
`accounts[].reviews`	AVAILABLE, RECONNECT_REQUIRED oder UNSUPPORTED für diesen Kanal. Siehe unten

Kanalzugriff

Wert	Beschreibung
`AVAILABLE`	Das Konto kann diesen Kanal nutzen
`RECONNECT_REQUIRED`	Die Plattform hat den Kanal, aber dieser Verbindung fehlt die Berechtigung dafür, oder ihr Token ist abgelaufen. Schreibzugriffe antworten mit 403 inbox_reconnect_required, bis die Person das Konto in AdaptlyPost neu verbindet
`UNSUPPORTED`	Die Plattform hat diesen Kanal nicht

Konten sofort lesen

POSThttps://post.adaptlypost.com/post/api/v1/inbox/refresh

Stellt einen Lesevorgang für jedes verbundene Konto in die Warteschlange, statt auf den nächsten 10-Minuten-Lauf zu warten, und antwortet mit 202 { "queued": true }. Die Listen ändern sich, sobald der Lesevorgang fertig ist.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.readRollen und Berechtigungen

Ablehnungen

Ein abgelehnter Aufruf antwortet mit { statusCode, error, code, message }. Werten Sie code aus. message erklärt die Ablehnung in Worten.

Code	Status	Wann, und was zu tun ist
`inbox_item_not_found`	404	Die ID existiert nicht oder gehört zu einem anderen Workspace. Abbrechen
`inbox_action_unsupported`	400	Die Plattform oder dieser Eintrag erlaubt dieses Ausblenden, Löschen oder Liken nicht. capabilities sagt, was möglich ist. Abbrechen
`inbox_reconnect_required`	403	Der Verbindung fehlt die Berechtigung für diesen Kanal oder diese Aktion, auch eine, die die Plattform noch prüft, oder ihr Token ist abgelaufen. Bitten Sie die Person, das Konto in AdaptlyPost neu zu verbinden. Nicht erneut versuchen
`inbox_reply_invalid`	400	Der Text ist leer oder zu lang. Die Meldung nennt das Limit. Text korrigieren
`inbox_messaging_window_closed`	400	Facebook oder Instagram: Das 24-Stunden-Antwortfenster ist abgelaufen. Abbrechen
`inbox_rate_limited`	429	Die Plattform hat AdaptlyPost gedrosselt. Nach einer Weile erneut versuchen
`inbox_platform_error`	503	Die Plattform ist fehlgeschlagen. Später erneut versuchen
`permission_denied`	403	Der Rolle des Schlüssels fehlt inbox.read oder inbox.reply. Nicht erneut versuchen
`subscription_required`	403	Ein Schreibzugriff ohne aktiven AdaptlyPost-Tarif. Nicht erneut versuchen

Posteingang-Übersicht lesen

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/inbox/summary \
  --header 'Authorization: Bearer <api-key>'

Sofort einen Lesevorgang anfordern

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/refresh \
  --header 'Authorization: Bearer <api-key>'

202
{ "queued": true }

200

{
  "unread": {
    "comments": 12,
    "mentions": 3,
    "conversations": 2,
    "reviews": 1
  },
  "accounts": [
    {
      "accountId": "conn_ig_001",
      "platform": "INSTAGRAM",
      "accountName": "adaptlypost",
      "avatarUrl": "https://cdn.adaptlypost.com/avatars/ig_001.jpg",
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:40:12.000Z",
      "lastErrorCode": null,
      "comments": "AVAILABLE",
      "mentions": "AVAILABLE",
      "messages": "RECONNECT_REQUIRED",
      "reviews": "UNSUPPORTED"
    },
    {
      "accountId": "conn_gbp_001",
      "platform": "GOOGLE_BUSINESS",
      "accountName": "AdaptlyPost Kraków",
      "avatarUrl": null,
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:38:55.000Z",
      "lastErrorCode": null,
      "comments": "UNSUPPORTED",
      "mentions": "UNSUPPORTED",
      "messages": "UNSUPPORTED",
      "reviews": "AVAILABLE"
    }
  ]
}