Accounts

Connect a new social account

Initiates the OAuth connection flow for a new social media account. Returns a connect_url that should be opened in a browser popup. Optionally provide a postback_url to receive a webhook notification when the connection completes.

post/accounts

Request

  • Base URL: https://socialbu.com/api/v1
  • URL: https://socialbu.com/api/v1/accounts
  • Auth: HTTP bearer

Request body

providerstring required

Social media network name e.g, (Instagram, Twitter etc.)

postback_urlstring

Receive postback at this URL. Sends a JSON POST request with parameters account_action (added, updated, connected, disconnected), account_id, account_type, and account_name. The account_action is disconnected if an account is found disconnected by the system, connected if a previously disconnected account is reconnected by the system automatically, added when a new account is added/connected for the first time, and updated when an existing account is reconnected.

account_idstring

Social account id if reconnecting an existing account.

Response

You get the URL for connecting social accounts. Recommended to open it in a popup.

connect_urlstring uri

URL that you can visit to add your accounts

Changes

No recorded changes to this operation across all 1 revision of this API.