Queries
Social Accounts
Query connected social media accounts across all platforms.
The socialAccounts query returns the social media accounts connected to your Postpone account.
SocialAccountType
id
ID!
Unique identifier for the social account.
username
String
The platform username for this account.
formattedUsername
String
A display-formatted version of the username (e.g.
u/myuser for Reddit, @myuser for Twitter).name
String
The display name associated with this account.
platform
String
The social media platform (e.g.
reddit, twitter, instagram).avatarUrl
String
URL to the account's profile avatar image.
profileUrl
String
URL to the account's public profile page.
description
String
Bio or description text from the platform profile.
followers
Int
Number of followers or subscribers.
isConnected
Boolean
Whether Postpone currently has a valid connection to this account.
isEnabled
Boolean
Whether this account is enabled for scheduling.
verified
Boolean
Whether the account is verified on the platform.
dateCreated
DateTime
When this social account was connected to Postpone.
socialAccounts Query
Returns a list of connected social accounts, optionally filtered by platform.
platform
String
Optional. Filter results to a specific platform. Accepted values:
reddit, twitter, instagram, facebook, threads, bluesky, tiktok, youtube, linkedin, pinterest, mastodon, tumblr.List All Connected Accounts
query socialAccounts {
socialAccounts {
id
username
formattedUsername
name
platform
followers
avatarUrl
profileUrl
isConnected
isEnabled
verified
}
}
{
"data": {
"socialAccounts": [
{
"id": "789",
"username": "myreddituser",
"formattedUsername": "u/myreddituser",
"name": "My Reddit Account",
"platform": "reddit",
"followers": 1250,
"avatarUrl": "https://example.com/avatar.png",
"profileUrl": "https://reddit.com/u/myreddituser",
"isConnected": true,
"isEnabled": true,
"verified": false
},
{
"id": "790",
"username": "mytwitter",
"formattedUsername": "@mytwitter",
"name": "My Twitter Account",
"platform": "twitter",
"followers": 3400,
"avatarUrl": "https://example.com/twitter-avatar.png",
"profileUrl": "https://twitter.com/mytwitter",
"isConnected": true,
"isEnabled": true,
"verified": false
}
]
}
}
Filter by Platform
query socialAccounts($platform: String) {
socialAccounts(platform: $platform) {
id
username
formattedUsername
name
platform
followers
isConnected
isEnabled
}
}
{
"platform": "instagram"
}
{
"data": {
"socialAccounts": [
{
"id": "791",
"username": "myinstaaccount",
"formattedUsername": "@myinstaaccount",
"name": "My Instagram",
"platform": "instagram",
"followers": 8200,
"isConnected": true,
"isEnabled": true
}
]
}
}