Platforms, unified entities, vendor APIs, endpoints and connectors.
social.eventUnifiedSoonPublished, failed, comment received, connection expiring. Sent by webhook.
key event name6 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.
/ v1/ social/ webhooksRegister a URL and the events to push to itAll 9 social platformsDraft/ v1/ social/ webhooksYour webhooks and their eventsAll 9 social platformsDraft/ v1/ social/ webhooks/ {webhookId}Remove a webhookAll 9 social platformsDraft/ v1/ social/ webhooks/ {webhookId}/ testSend a test eventAll 9 social platformsDraft/ v1/ social/ eventsRecent events and whether each was deliveredAll 9 social platformsDraft/ v1/ social/ events/ {eventId}/ redeliverSend a missed event againAll 9 social platformsDraftA first cut of the schema from the Q4 entity model. Names, types and coverage can change before the Unified layer ships.
namestringReportedFor example publication.published or connection.expiringoccurred_atdatetimeReportedsubjectRefReportedThe Publication, Post, Comment or Connection it is aboutworkspaceWorkspaceReporteddelivery_idstringReportedThe same on every retryattemptintegerReportedVendor 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 Event yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.
AIsa publication_idOne post sent to several accounts, with draft, schedule and approval.
workspace + accountYour permission to act for an account: scopes, status, expiry.
AIsa workspace_idThe accounts of one brand, or of one client for an agency.