Comment Plugs

Get Comment Plug config

Reads the default Comment Plug (automatic first-comment) settings for one or all LinkedIn profiles in the workspace.

GET/api/public/comment-plugs/config
cURLGET /api/public/comment-plugs/config
curl "https://postiv.ai/api/public/comment-plugs/config" \
  -H "Authorization: Bearer pk_postiv_..."
200Response
{
  "success": true,
  "orgId": "9e6397ad-...",
  "profiles": [
    {
      "id": 1234,
      "profileType": "personal",
      "name": "Jan",
      "cmmConnected": true,
      "config": {
        "enabled": true,
        "delayMinutes": 30,
        "selectionMode": "random",
        "variants": [
          {
            "id": "v1",
            "text": "Grab the template here: ...",
            "useWhen": null,
            "imageSource": null
          }
        ]
      }
    }
  ],
  "config": null,
  "warnings": []
}

Authorization

Requires an organization API key with the profiles:read scope, sent as Authorization: Bearer or x-api-key.

Query parameters

integrationIdint

One profile. Alias: integration_id. Omit to list all profiles.

Response

Profiles with their Comment Plug config (defaulted when unset).

orgIduuid
profiles[].idint
profiles[].profileTypestring
profiles[].namestring|null
profiles[].cmmConnectedboolean

Whether LinkedIn's comment-management permission is connected; enabled configs require this true.

profiles[].config.enabledboolean
profiles[].config.delayMinutesint

Default/minimum 15.

profiles[].config.selectionModestring
profiles[].config.variantsarray

[{ id, text, useWhen, imageSource }]

configobject|null

Convenience: same as profiles[0].config when integrationId was passed; null otherwise.

warningsstring[]

e.g. a note if the comment_plug_configs table isn't migrated yet.

Errors

400invalid_integration_id: integrationId not a positive integer
404linkedin_profile_not_found: integrationId given but not in this workspace

Good to know

  • Call before relying on schedule_post's commentPlug 'inherit' mode: inherit only actually posts a comment when enabled, has variants, and cmmConnected is true.