Comment Plugs

Set Comment Plug config

Sets the profile-level default Comment Plug used by future scheduled posts that inherit it. Not a per-post override: use schedule_post's commentPlug for that.

POST/api/public/comment-plugs/config

cURLPOST /api/public/comment-plugs/config

curl -X POST https://postiv.ai/api/public/comment-plugs/config \
  -H "Authorization: Bearer pk_postiv_..." \
  -H "Content-Type: application/json" \
  -d '{
    "integrationId": 123,
    "enabled": true
  }'

200Response

{
  "success": true,
  "profile": {
    "id": 1234,
    "profileType": "personal",
    "name": "Jan",
    "cmmConnected": true
  },
  "config": {
    "id": "cfg-1",
    "orgId": "9e6397ad-...",
    "integrationId": 1234,
    "enabled": true,
    "delayMinutes": 30,
    "selectionMode": "random",
    "variants": [],
    "createdAt": "...",
    "updatedAt": "..."
  }
}

Authorization

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

Body parameters

integrationIdintrequired

Alias: integration_id.

enabledbooleanrequired

delayMinutesint

Alias: delay_minutes. Minimum 15 (validated server-side).

selectionModestring

Alias: selection_mode.

One of:randomrouted

variantsarraydefault:

Max 5. Each: { id?, text (max 1250), useWhen? (max 240, alias use_when/routeHint), imageSource? (max 2000, alias image_source/imageUrl) }.

Response

The saved profile + config.

profileobject

Same shape as a GET profiles[] entry.

configobject

The saved config row, same shape as GET's profiles[].config plus id/orgId/createdAt/updatedAt.

Errors

400	missing_integration_id / invalid_comment_plug_config: validation failure (e.g. enabled=true with no variants, delay < 15)
400	linkedin_cmm_reconnect_required: enabled=true but the profile's LinkedIn comment-management permission isn't connected
404	linkedin_profile_not_found
503	comment_plug_tables_missing: migration not yet run in this environment

Good to know

To disable the default, set enabled=false (variants can be empty).