Socials

About

Payload plugin for organic social publishing across Pinterest, Instagram Business, Facebook Pages, and Google Business Profile. It ships real API adapters for each platform, an AES-256-GCM encrypted connections global with key rotation, idempotent publication, a durable audit trail, and Payload-native admin surfaces. A per-record Socials composer can be injected into any host collection, and a standalone multi-channel composer lives at `/admin/socials`. The plugin registers two plugin-owned collections (`social-posts`, `social-templates`) and a hidden `socials-connections` global. It extends Payload through collections, globals, REST endpoints, Payload Jobs task definitions, admin nav, and a dashboard widget. Job tasks cover scheduled publication, retries, insight refreshes, and credential refresh. The host supplies source resolvers, authorization, the encryption key, and decides when workers run. Configuration is host-defined. You map collections to source kinds, provide per-platform OAuth or service-account credentials, and supply an `authorize` function for access scopes. Each platform exposes its own options: redirect URIs, system-user credentials, and enabled flags. Per-platform copy transforms, `copyOverrides`, and templating let every host replace default generated copy. Optional image-format preflight and deterministic JPEG rendition generation use `sharp`. Pinterest image and video Pins, Instagram images, Reels, Stories, Carousels, Facebook link, photo, multi-photo, and video posts, and GBP Standard, Event, Offer, and Alert Local Posts are supported. Every composer capability is also an authenticated HTTP surface so AI agents or headless clients can drive discovery, validation, publish, history, deletion, and reconciliation. Meta apps must be Live for public visibility, and Google Business Profile support is API-complete but experimental. The plugin never creates or runs migration files.

Package info

Package name

payload-plugin-socials

Latest version

0.11.1

Unpacked size

1 MB

License

MIT

Weekly downloads

175

Last publish

Oct 24, 2026