Platforms, unified entities, vendor APIs, endpoints and connectors.
social.conversationUnifiedSoonA DM thread and its messages, where the platform allows it.
key platform + conversation ID4 planned callsNo Direct endpoint yet
Our own first draft of the paths, not reviewed yet. Each call acts on the platforms it lists through the Connection you grant, and none is deployed yet.
/DM threads, newest firstX · Instagram · Facebook · RedditDraft/One thread and its messagesX · Instagram · Facebook · RedditDraft/Send a message with text or mediaX · Instagram · Facebook · RedditDraft/Mark a thread read or archive itX · Instagram · Facebook · RedditDraftA first cut of the schema from the Q4 entity model. Names, types and coverage can change before the Unified layer ships.
accountAccountReportedparticipantsAccount[]ReportedmessagesMessage[]Reportedlast_message_atdateReportedunread_countintegerReportedcan_replybooleanReportedWhile the platform’s reply window is openVendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
No Direct endpoint returns Conversation yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.
platform + account IDAny account: yours, a creator's or a competitor's.
platform + comment IDA comment, reply or page review. Read, reply, hide or delete.
workspace + accountYour permission to act for an account: scopes, status, expiry.