Social accounts API
Connect, disconnect and inspect social accounts; pick channels; create hosted connect links for your own users.
| Operation | Method and path |
|---|---|
| Connect social account for team | POST /api/v1/social-account/connect |
| Disconnect social account from team | DELETE /api/v1/social-account/disconnect |
| Set channel for social account | POST /api/v1/social-account/set-channel |
| Unset channel for social account | POST /api/v1/social-account/unset-channel |
| Refresh channels for social account | POST /api/v1/social-account/refresh-channels |
| Create portal link | POST /api/v1/social-account/create-portal-link |
| Enable DM messaging for a social account | POST /api/v1/social-account/messaging/enable |
| Disable DM messaging for a social account | POST /api/v1/social-account/messaging/disable |
| Manually run connection/disconnect check | POST /api/v1/social-account/connection-check |
| Manually refresh social account profile info | POST /api/v1/social-account/profile-refresh |
| Get social account by team and type | GET /api/v1/social-account/by-type |
| Copy social accounts | POST /api/v1/social-account/copy |
| Get paginated social accounts scheduled to delete | GET /api/v1/social-account/to-delete |
/api/v1/social-account/disconnect Disconnect social account from team
socialAccount.disconnect · requires x-api-key
Request body application/json
-
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required
Example
curl -X DELETE "https://api.siaran.my/api/v1/social-account/disconnect" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"type": "TIKTOK",
"teamId": "TEAM_ID"
}' Response 200
26 top-level fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/set-channel Set channel for social account
socialAccount.setChannel · requires x-api-key
Request body application/json
-
typestring requiredOne of:FACEBOOKINSTAGRAMLINKEDINYOUTUBEGOOGLE_BUSINESS -
teamIdstring required -
channelIdstring required
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/set-channel" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"type": "FACEBOOK",
"teamId": "TEAM_ID",
"channelId": "CHANNEL_ID"
}' Response 200
26 top-level fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/unset-channel Unset channel for social account
socialAccount.unsetChannel · requires x-api-key
Request body application/json
-
typestring requiredOne of:FACEBOOKINSTAGRAMLINKEDINYOUTUBEGOOGLE_BUSINESS -
teamIdstring required
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/unset-channel" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"type": "FACEBOOK",
"teamId": "TEAM_ID"
}' Response 200
26 top-level fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/refresh-channels Refresh channels for social account
socialAccount.refreshChannels · requires x-api-key
Request body application/json
-
typestring requiredOne of:DISCORDSLACKREDDITPINTERESTFACEBOOKINSTAGRAMLINKEDINYOUTUBEGOOGLE_BUSINESS -
teamIdstring required
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/refresh-channels" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"type": "DISCORD",
"teamId": "TEAM_ID"
}' Response 200
26 top-level fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/create-portal-link Create portal link
socialAccount.createPortalLink · requires x-api-key
Request body application/json
-
teamIdstring required -
redirectUrlstring uri -
socialAccountTypesstring[] requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
serverUrlstring uri -
disableAutoLoginboolean default false -
tiktokForceLoginboolean default false -
forceBrowserOAuthboolean default false -
instagramConnectionMethodstringOne of:FACEBOOKINSTAGRAM -
withBusinessScopeboolean -
withMessagingScopeboolean -
expiresIninteger ≥ 5≤ 2880 -
logoUrlstring uri -
userLogoUrlstring uri -
userNamestring -
goBackButtonTextstring -
hidePoweredByboolean -
hideGoBackButtonboolean -
hideUserLogoboolean -
hideUserNameboolean -
hideLanguageSwitcherboolean -
showModalOnConnectSuccessboolean -
languagestring default "en"One of:enplfrhisvdeesitnlptrutrzhdathkohear -
maxSocialAccountsConnectednumber
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/create-portal-link" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"teamId": "TEAM_ID",
"socialAccountTypes": [
"TIKTOK"
]
}' Response 200
1 top-level fields
-
urlstring required
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/messaging/enable Enable DM messaging for a social account
socialAccount.enableMessaging · requires x-api-key
Request body application/json
-
teamIdstring required -
typestring requiredOne of:FACEBOOKINSTAGRAM
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/messaging/enable" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"teamId": "TEAM_ID",
"type": "FACEBOOK"
}' Response 200
4 top-level fields
-
socialAccountIdstring required -
typestring requiredOne of:FACEBOOKINSTAGRAM -
messagingStatusstring requiredOne of:DISABLEDENABLEDDISABLE_PENDING -
messagingLastErrorstring required nullable
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/messaging/disable Disable DM messaging for a social account
socialAccount.disableMessaging · requires x-api-key
Request body application/json
-
teamIdstring required -
typestring requiredOne of:FACEBOOKINSTAGRAM
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/messaging/disable" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"teamId": "TEAM_ID",
"type": "FACEBOOK"
}' Response 200
4 top-level fields
-
socialAccountIdstring required -
typestring requiredOne of:FACEBOOKINSTAGRAM -
messagingStatusstring requiredOne of:DISABLEDENABLEDDISABLE_PENDING -
messagingLastErrorstring required nullable
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/connection-check Manually run connection/disconnect check
socialAccount.connectionCheck · requires x-api-key
Request body application/json
-
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/connection-check" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"type": "TIKTOK",
"teamId": "TEAM_ID"
}' Response 200
8 top-level fields
-
successboolean required -
messagestring -
socialAccountIdstring required -
checkedAtstring required -
limitinteger required ≥ 1 -
usedinteger required ≥ 0 -
remaininginteger required ≥ 0 -
windowSecondsinteger required ≥ 1
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/profile-refresh Manually refresh social account profile info
socialAccount.profileRefresh · requires x-api-key
Request body application/json
-
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/profile-refresh" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"type": "TIKTOK",
"teamId": "TEAM_ID"
}' Response 200
9 top-level fields
-
successboolean required -
messagestring -
socialAccountIdstring required -
socialAccountobject required26 fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
-
-
refreshedAtstring required -
limitinteger required ≥ 1 -
usedinteger required ≥ 0 -
remaininginteger required ≥ 0 -
windowSecondsinteger required ≥ 1
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/by-type Get social account by team and type
socialAccount.getByType · requires x-api-key
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
type required | query | string | One of TIKTOK, YOUTUBE, INSTAGRAM, FACEBOOK, TWITTER, THREADS, LINKEDIN, PINTEREST, REDDIT, MASTODON, DISCORD, SLACK, BLUESKY, GOOGLE_BUSINESS, SNAPCHAT |
teamId required | query | string |
Example
curl -X GET "https://api.siaran.my/api/v1/social-account/by-type?type=TIKTOK&teamId=TEAM_ID" \
-H "x-api-key: $SIAR_API_KEY" Response 200
26 top-level fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/copy Copy social accounts
socialAccount.copy · requires x-api-key
Request body application/json
-
fromTeamIdstring required -
toTeamIdstring required -
resetChannelboolean -
socialAccountTypesstring[] required min 1 itemsOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT
Example
curl -X POST "https://api.siaran.my/api/v1/social-account/copy" \
-H "x-api-key: $SIAR_API_KEY" \
-H "content-type: application/json" \
-d '{
"fromTeamId": "FROMTEAM_ID",
"toTeamId": "TOTEAM_ID",
"socialAccountTypes": [
"TIKTOK"
]
}' Response 200
26 top-level fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/to-delete Get paginated social accounts scheduled to delete
socialAccount.getAccountsToDelete · requires x-api-key
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
page | query | number | default 1 |
pageSize | query | number | default 20 |
Example
curl -X GET "https://api.siaran.my/api/v1/social-account/to-delete" \
-H "x-api-key: $SIAR_API_KEY" Response 200
2 top-level fields
-
itemsobject[] required26 fields
-
idstring required -
typestring requiredOne of:TIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHAT -
teamIdstring required -
usernamestring nullable -
displayNamestring nullable -
biostring nullable -
avatarUrlstring nullable -
externalIdstring nullable -
providerPageIdstring nullable -
userUsernamestring nullable -
userDisplayNamestring nullable -
userEmailstring nullable -
userIdstring nullable -
channelsobject[] nullable7 fields
-
idstring required -
namestring nullable -
usernamestring nullable -
addressstring nullable -
avatarUrlstring nullable -
webhookobject nullable4 fields
-
idstring nullable -
namestring nullable -
avatarstring nullable -
urlstring nullable
-
-
metadataobject nullable5 fields
-
allowImagesboolean nullable -
allowVideosboolean nullable -
allowGalleriesboolean nullable -
linkFlairEnabledboolean nullable -
facebookPageIdstring nullable
-
-
-
mastodonServerIdstring nullable -
instagramConnectionMethodstring nullableOne of:FACEBOOKINSTAGRAM -
twitterSubTypestring nullableOne of:nonebasicpremiumpremium_plus -
isTiktokBusinessAccountboolean nullable -
disconnectedCheckTryAtstring nullable date-time -
deleteOnstring nullable date-time -
messagingStatusstring default "DISABLED"One of:DISABLEDENABLEDDISABLE_PENDING -
messagingStatusUpdatedAtstring nullable date-time -
messagingLastErrorstring nullable -
createdAtstring required nullable date-time -
updatedAtstring required nullable date-time -
deletedAtstring nullable date-time
-
-
paginationobject required4 fields
-
pagenumber required -
pageSizenumber required -
totalnumber required -
totalPagesnumber required
-
Errors: 400 Validation failed · 401 Missing or invalid API key · 403 Plan limit or permission · 404 Not found · 429 Rate limited · 500 Server error · 502 Network error
/api/v1/social-account/connectConnect social account for team
socialAccount.connect· requires x-api-keyRequest body
application/jsontypestring requiredTIKTOKYOUTUBEINSTAGRAMFACEBOOKTWITTERTHREADSLINKEDINPINTERESTREDDITMASTODONDISCORDSLACKBLUESKYGOOGLE_BUSINESSSNAPCHATteamIdstring requiredredirectUrlstring required uriserverUrlstring uridisableAutoLoginboolean default falsetiktokForceLoginboolean default falseforceBrowserOAuthboolean default falseinstagramConnectionMethodstringFACEBOOKINSTAGRAMwithBusinessScopeboolean default falsewithMessagingScopeboolean default falseExample
Response
2001 top-level fields
urlstring requiredErrors:
400Validation failed ·401Missing or invalid API key ·403Plan limit or permission ·404Not found ·429Rate limited ·500Server error ·502Network error