POST /api/v4/twitter_accounts
Create Twitter Account for User

Request headers

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Request body example

{
  "twitter_account": {
    "twitter_token": "TWITTER_TOKEN",
    "twitter_uid": "TWITTER_UID",
    "screen_name": "NAME",
    "logo_url": "LOGO_URL",
    "account_verified": true,
    "twitter_nickname": "SCREEN_NAME",
    "location": guidedWalkthrough
  }
}

Success response body

{
  "success": true,
  "twitter_account": {
    "id": 3,
    "social_channel": "Twitter",
    "name": "USERNAME",
    "nickname": "USER NICKNAME",
    "logo": "LINK TO LOGO"
    "twitter_nickname": "GipperWorker"
  }
}

Error response body

# for admins
{
  "success": false,
  "message": ["To connect this social media account to your Personal, you must first remove it from your Workspace accounts"]
}
# for members
{
  "success": false,
  "message": ["This social account is already connected to your Workspace! Please ask example@mail.com for access"]
}

Errors

Code Description
422 Could not save the entity.

Params

Param name Description
twitter_account
required

Validations:

  • Must be a Hash

twitter_account[twitter_token]
required

Validations:

  • Must be a String

twitter_account[twitter_uid]
required

Validations:

  • Must be a String

twitter_account[screen_name]
required

Validations:

  • Must be a String

twitter_account[logo_url]
required

Validations:

  • Must be a String

twitter_account[account_verified]
optional

Validations:

  • Must be one of: true, false, 1, 0.

twitter_account[twitter_nickname]
required

Validations:

  • Must be a String

twitter_account[location]
optional

Validations:

  • Must be one of: workspaceSettingsPage, signUpForm, guidedWalkthrough, progressMeter, personalSettingsPage, templateBranding.


GET /api/v4/twitter_accounts/search_users
Search many users. Last Update: 01/11/23

Request headers

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Success response body

{
  "accounts": [
    {
      "icon_url": "https://pbs.twimg.com/profile_images/1590968738358079488/IY9Gx6Ok_normal.jpg",
      "screen_name": "elonmusk",
      "name": "Elon Musk"
    },
    {
      "icon_url": "https://pbs.twimg.com/profile_images/1561717677600686083/Dm80jwOp_normal.jpg",
      "screen_name": "MattWallace888",
      "name": "Matt Wallace"
    },
    {
      "icon_url": "https://pbs.twimg.com/profile_images/1595223996249026560/CwdKYgll_normal.jpg",
      "screen_name": "NFPICT",
      "name": "Stop Bigots and Fascists like @elonmusk"
    }...
  ],
  "error": false
}

Params

Param name Description
search_query
required

Twitter user name

Validations:

  • Must be a String

twitter_account_ids
optional

Selected for publish twitter account IDs

Validations:

  • Must be an array of Integer


DELETE /api/v4/twitter_accounts/:id
Delete User Twitter Account

Request headers

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Success response body

{
  "success": true
}

Params

Param name Description
id
required

ID of Twitter Account

Validations:

  • Must be a Integer