Posts

Arm a plug on a post

Watches the target and fires once when the metric reaches the threshold: repost (X) or add a comment (X, Instagram, Facebook, LinkedIn company pages). The post must be scheduled or live. At most 3 plugs per target and 10 armed per user. X is checked every 30 minutes for 24 hours; Instagram, Facebook and LinkedIn pages every 5 minutes for the first hour, then every 30, for 48 hours. A personal LinkedIn account cannot carry a plug.

post/posts/{id}/plugs

Request

  • Base URL: https://www.sociahive.com/api/v1
  • URL: https://www.sociahive.com/api/v1/posts/{id}/plugs
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (authorization code, authorization URL /api/oauth/authorize, token URL /api/oauth/token, scopes: posts:write)

Path parameters

idstring required

MongoDB ObjectId (24-character hex string)

Example:507f1f77bcf86cd799439011

Request body

account_idstring required

MongoDB ObjectId (24-character hex string)

Example request

{
  "account_id": "507f1f77bcf86cd799439011"
}

Response

Plug armed

successtrue required

Example response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "post_id": "507f1f77bcf86cd799439011",
    "account_id": "507f1f77bcf86cd799439011"
  }
}

Changes

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