PostSider API channels

Channels are the social media accounts connected to your PostSider organization. The channel endpoints let you list active channels (to get the ids you need for scheduling), start a connection flow for a new account, disconnect a channel, and pull account-level analytics for a connected channel.

GET /public/v1/integrations

Returns all channels connected to your organization. You need the channel id values when scheduling posts with POST /public/v1/posts.

Query parameters

string

Optional channel group id to filter the list to a single group.

Example

curl https://api.postsider.com/public/v1/integrations \
  -H 'Authorization: your-api-key'

Response

[
  {
    "id": "ch_abc123",
    "name": "My X",
    "identifier": "x",
    "profile": "@myhandle",
    "picture": "https://api.postsider.com/uploads/avatars/myhandle.jpg",
    "disabled": false,
    "customer": { "id": "grp_1", "name": "Acme" }
  }
]

string

The unique channel identifier. Pass this value as integration.id when creating a post.

string

The human-readable name you assigned to this channel in PostSider.

string

The platform identifier, for example x, linkedin, or instagram.

string

The platform-specific handle or slug for the connected account.

boolean

Whether the channel is currently disabled.

object

The channel group this channel belongs to, if any.

GET /public/v1/groups

Returns the channel groups (customers) configured in your organization. Use a group id to filter GET /public/v1/integrations.

Example

curl https://api.postsider.com/public/v1/groups \
  -H 'Authorization: your-api-key'

Response

[
  { "id": "grp_1", "name": "Acme" },
  { "id": "grp_2", "name": "Personal" }
]

Starts a connection flow for a platform and returns the authorization URL to open in a browser. After the user approves access, the channel is added to your organization and appears in GET /public/v1/integrations.

Path parameters

string

required

The platform identifier to connect, for example x, linkedin, or mastodon.

Query parameters

string

Optional. Pass an existing channel id to refresh (reconnect) that account instead of adding a new one.

Example

curl https://api.postsider.com/public/v1/social/linkedin \
  -H 'Authorization: your-api-key'

Response

{ "url": "https://www.linkedin.com/oauth/v2/authorization?client_id=..." }

Some platforms (for example Bluesky, Telegram, and Nostr) connect with credentials entered in the PostSider dashboard rather than an OAuth redirect. Those are not connected through this endpoint.

DELETE /public/v1/integrations/:id

Disconnects a channel from your organization. Any posts scheduled to that channel are removed as well.

Path parameters

string

required

The id of the channel to disconnect. Use the id from GET /public/v1/integrations.

Example

curl -X DELETE https://api.postsider.com/public/v1/integrations/ch_abc123 \
  -H 'Authorization: your-api-key'

GET /public/v1/analytics/:integration

Returns account-level analytics for a connected channel. The response shape depends on the platform and what its reporting API exposes.

Path parameters

string

required

The id of the connected channel. Use the id from GET /public/v1/integrations.

Query parameters

string

Provider-specific date or range parameter, where the platform requires one.

Example

curl 'https://api.postsider.com/public/v1/analytics/ch_abc123?date=7' \
  -H 'Authorization: your-api-key'

Analytics availability depends on the platform and the connected account’s permissions. Some platforms only report for business or creator accounts, and some report no data at all.

Overview

MCP Server

REST API

SDK

PostSider API channels

GET /public/v1/integrations

Query parameters

Example

Response

GET /public/v1/groups

Example

Response

Path parameters

Query parameters

Example

Response

DELETE /public/v1/integrations/:id

Path parameters

Example

GET /public/v1/analytics/:integration

Path parameters

Query parameters

Example

​GET /public/v1/integrations

​Query parameters

​Example

​Response

​GET /public/v1/groups

​Example

​Response

​GET /public/v1/social/:integration

​Path parameters

​Query parameters

​Example

​Response

​DELETE /public/v1/integrations/:id

​Path parameters

​Example

​GET /public/v1/analytics/:integration

​Path parameters

​Query parameters

​Example

GET /public/v1/integrations

Query parameters

Example

Response

GET /public/v1/groups

Example

Response

GET /public/v1/social/:integration

Path parameters

Query parameters

Example

Response

DELETE /public/v1/integrations/:id

Path parameters

Example

GET /public/v1/analytics/:integration

Path parameters

Query parameters

Example