Social

The Social module manages connected publishing destinations, scheduled publications, synced comments, comment threads, replies, classification, and engagement metrics.

Social connections use the dedicated Social API. Store deploy hooks, payments, and managed shipping use their own SDK surfaces.

Social Connections

const capabilities = await sdk.social.connection.getCapabilities();

const { authorization_url } = await sdk.social.connection.connect({
	type: "instagram_business",
});

const connections = await sdk.social.connection.list();

Publications

const content = {
	type: "instagram_business",
	caption: "New work is live",
	placement: "reel",
	share_to_feed: true,
	media_ids: ["media_reel_123"],
};

const validation = await sdk.social.publication.validate({
	social_connection_id: connections[0].id,
	content,
});

const { publication } = await sdk.social.publication.create({
	social_connection_id: connections[0].id,
	content,
});

await sdk.social.publication.schedule({
	id: publication.id,
	scheduled_at: Math.floor(Date.now() / 1000) + 3600,
});

social_connection_id is the ID returned by sdk.social.connection.list().

Comments And Threads

await sdk.social.publication.syncEngagement({
	publication_ids: [publication.id],
	max_publications: 1,
	max_comment_pages_per_publication: 1,
	max_comments_per_publication: 50,
	sync_metrics: true,
});

const topLevel = await sdk.social.publication.getComments({
	publication_id: publication.id,
	limit: 50,
});

const thread = await sdk.social.publication.getCommentThread({
	publication_id: publication.id,
	comment_id: topLevel.items[0].id,
});

await sdk.social.publication.commentReply.create({
	publication_id: publication.id,
	comment_id: topLevel.items[0].id,
	reply_id: crypto.randomUUID(),
	text: "Thanks for reaching out.",
});

Comment sync stores top-level comments by default. Opening a thread fetches the provider thread for that root comment and stores replies with parent IDs so Admin can show the conversation tree.

Classification And Metrics

await sdk.social.publication.classifyComments({
	publication_id: publication.id,
	force: false,
	limit: 50,
});

const metrics = await sdk.social.publication.getMetrics({
	publication_id: publication.id,
});