REST APIGET

Posteingang: Erwähnungen

Listen Sie die Beiträge und Kommentare auf, die Ihre Konten auf Facebook, Instagram, Threads, Bluesky und Mastodon erwähnen, antworten Sie darauf und markieren Sie sie als gelesen.

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

Gibt Beiträge und Kommentare zurück, die Ihre Konten erwähnen, die neuesten zuerst. Antwortet mit { mentions, total, hasMore, nextCursor }.

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.

Abfrageparameter

Parameter	Typ	Beschreibung
`accountIds`	`string[]`	Nur diese Konten, mit der id aus GET /social-accounts. Schlüssel wiederholen oder Werte mit Kommas trennen. Bis zu 50
`platforms`	`PlatformType[]`	Nur diese Plattformen. Schlüssel wiederholen oder Werte mit Kommas trennen
`statuses`	`InboxStatus[]`	Nur Einträge in diesen Zuständen: UNREAD, READ oder DONE. Schlüssel wiederholen oder Werte mit Kommas trennen
`since`	`string (ISO 8601)`	Nur Einträge, die auf der Plattform zu oder nach diesem Zeitpunkt erstellt wurden
`search`	`string`	Suchtext
`limit`	`number`	Einträge pro Seite, 1 bis 100. Standard 25
`cursor`	`string`	Der nextCursor der vorherigen Seite. Auf der letzten Seite ist nextCursor null

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.

Felder einer Erwähnung

Feld	Beschreibung
`id`	Erwähnungs-ID. Verwenden Sie sie mit den Endpunkten unten
`accountId`	Das Konto, zu dem der Eintrag gehört: seine id aus GET /social-accounts
`platform`	Die Plattform als PlatformType
`accountName`	Anzeigename dieses Kontos
`platformMentionId`	Die ID der Plattform für den Beitrag oder Kommentar, der das Konto erwähnt
`author`	Wer es geschrieben hat: id (die Nutzer-ID der Plattform), name, username und avatarUrl. id, username und avatarUrl können null sein
`text`	Der Text, der das Konto erwähnt
`permalink`	Öffentlicher Link auf der Plattform oder null, wenn die Plattform keinen liefert
`thumbnailUrl`	Bild des Beitrags oder null
`createdAt`	Wann es auf der Plattform erstellt wurde
`status`	UNREAD, READ oder DONE. Nur AdaptlyPost speichert diesen Zustand; die Plattform sieht ihn nicht
`replied`	True, wenn Ihr Konto über AdaptlyPost geantwortet hat
`repliedAt`	Wann Ihr Konto zuletzt geantwortet hat, oder null
`capabilities`	canReply: false, wenn die Plattform das Konto nicht antworten lässt, wie bei Instagram-Erwähnungen
`replies`	Über AdaptlyPost gesendete Antworten, die ältesten zuerst, jeweils mit id, text, permalink und createdAt. Antworten aus der App der Plattform werden nicht aufgeführt

Auf eine Erwähnung antworten

POSThttps://post.adaptlypost.com/post/api/v1/inbox/mentions/:id/reply

Antwortet mit dem erwähnten Konto auf den Beitrag oder Kommentar und antwortet mit 201 und der Erwähnung. Auf Mastodon behält die Antwort die Sichtbarkeit des ursprünglichen Beitrags.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

Schreibzugriffe brauchen inbox.reply (Admin und Redakteur) und einen aktiven AdaptlyPost-Tarif. Ohne Tarif antworten sie mit 403 subscription_required.

Body-Parameter

Parameter	Typ	Beschreibung
`text`ERFORDERLICH	`string`	Die Antwort. Es gilt das Kommentarlimit der Plattform: Threads 500, Bluesky 300, Mastodon 500 und Facebook 8000 Zeichen

Als gelesen oder erledigt markieren

POSThttps://post.adaptlypost.com/post/api/v1/inbox/mentions/status

Setzt den Status von bis zu 100 Erwähnungen und antwortet mit { mentions, unreadCount }.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

Body-Parameter

Parameter	Typ	Beschreibung
`ids`ERFORDERLICH	`string[]`	1 bis 100 IDs aus der Liste
`status`ERFORDERLICH	`InboxStatus`	UNREAD, READ oder DONE

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

Neue Erwähnungen auflisten

curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/inbox/mentions?statuses=UNREAD&since=2026-11-01T00:00:00Z' \
  --header 'Authorization: Bearer <api-key>'

Auf eine Erwähnung antworten

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/mentions/mnt_41c7e0b2/reply \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "Thanks for the shout-out!" }'

Eine Erwähnung als gelesen markieren

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/mentions/status \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": ["mnt_41c7e0b2"], "status": "READ" }'

200

{
  "mentions": [
    {
      "id": "mnt_41c7e0b2",
      "accountId": "conn_bsky_001",
      "platform": "BLUESKY",
      "accountName": "adaptlypost.com",
      "platformMentionId": "at://did:plc:4k2x.../app.bsky.feed.post/3lb2x7q",
      "author": {
        "id": "did:plc:7f3q2m",
        "name": "Marta Nowak",
        "username": "marta.bsky.social",
        "avatarUrl": null
      },
      "text": "Scheduling a month of posts with @adaptlypost.com took me 20 minutes",
      "permalink": "https://bsky.app/profile/marta.bsky.social/post/3lb2x7q",
      "thumbnailUrl": null,
      "createdAt": "2026-11-07T18:03:10.000Z",
      "status": "UNREAD",
      "replied": false,
      "repliedAt": null,
      "capabilities": { "canReply": true },
      "replies": []
    }
  ],
  "total": 3,
  "hasMore": false,
  "nextCursor": null
}