List a brand's connections

Lists the social accounts attached to one brand. Each row's id is the connection ID: the value you pass in connectedChannelIds when you want a post to go to specific channels, the value disconnect takes, and the socialConnectedChannelId that insights requires.

Use case: rendering the channel picker. Before showing a composer, read this list and offer one toggle per row, labelled with displayName and platform. A brand with an empty socialConnected array has nowhere to publish; send the user to a connection link instead.

Use case: confirming a connection landed. After the user returns from the hosted connection flow with status=success, poll this endpoint until the row whose id matches the connectedAccountId on the return URL appears. Connections are materialised asynchronously, so allow a few seconds and a couple of retries before showing an error.

Notes.

• platform is one of FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST.
• id is Synup's connection UUID, and the value every Social endpoint that takes a connection wants. referenceId is the platform's own account identifier — a Facebook Page ID, an Instagram business account ID — useful for matching against records you hold outside Synup, but never accepted as input here.
• archived: true with an archivedAt timestamp means the connection is gone, either because someone disconnected it, because the brand was archived, or because the platform revoked the token. A post targeting an archived channel fails with SY95045.
• listingConnectedAccountId is set only when the same account is also linked on the Listings side; it is null for a Social-only connection.
• Only one connection per platform per brand is used for publishing. Connecting the same platform again on the same brand replaces the previous channel rather than adding a second one.
• To see your account-wide connection usage against your cap rather than one brand's channels, call GET /social/limits.