Connected social accounts
GET/accounts
Responses
- 200Accounts a draft can go to.
›Response fields
dataobjectrequired›3 fields
accountsAccount[]required›7 fields
accountIduuidrequiredPass in
accountIdsto schedule or publish.platformstringrequired- THREADS
- YOUTUBE
- TIKTOK
- BLUESKY
- MASTODON
- DISCORD
displayNamestringrequiredconnectionStatusstringrequired- CONNECTED
- ERROR
publishingStatusstringrequired- AVAILABLE
- TEMPORARILY_UNAVAILABLE
- ACTION_REQUIRED
requiredActionstringrequired- NONE
- RECONNECT
- SELECT_ACCOUNT
- UPDATE_PERMISSIONS
- WAIT
- CONTACT_SUPPORT
groupIduuid | nullrequiredThe group this account is in, from
groups.
groupsAccountGroup[]requiredSets of accounts the team posts to together.
›3 fields
groupIduuidrequirednamestringrequirednotestring | nullrequiredWho the group speaks to and how it sounds.
truncatedbooleanrequired
- 400The body, query, or path did not validate.
- 401Missing, mistyped, or revoked key.
- 403Not on Scale, or the key's role cannot do this.
- 429Over a limit. Wait
Retry-Afterseconds. - 503Plan status or storage could not be reached; nothing ran. Wait
Retry-Afterseconds.
curl https://app.distinctful.com/api/v1/accounts \
-H "Authorization: Bearer $DISTINCTFUL_API_KEY"{
"data": {
"accounts": [
{
"accountId": "6f1c2a8e-4b0d-4c55-9a43-2f1e7c9b5d10",
"platform": "LINKEDIN",
"displayName": "Distinctful",
"connectionStatus": "CONNECTED",
"publishingStatus": "AVAILABLE",
"requiredAction": "NONE",
"groupId": "6f1c2a8e-4b0d-4c55-9a43-2f1e7c9b5d10"
}
],
"groups": [
{
"groupId": "6f1c2a8e-4b0d-4c55-9a43-2f1e7c9b5d10",
"name": "string",
"note": "Lead with the client quote."
}
],
"truncated": true
}
}