# Comment Automations API

> Comment-to-DM (ManyChat-style): keyword rules per account or post answer comments with a private DM (Instagram, Facebook) and / or a public reply (also TikTok, Threads, LinkedIn, YouTube, Bluesky, Reddit), with audience filters, follow gates, repeat policies and tracked links. Each comment is answered at most once.

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## List comment automations

`GET /comment-automations`

Access: `read` · MCP tool: `list-comment-automations` · Zernio: `GET /v1/comment-automations`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at, name)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string)
- `account_id` (string)
- `platform` (string)
- `trigger` (string)
- `is_active` (string)

```bash
curl "https://api.socialit.com/v1/comment-automations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "comment_automation",
      "id": "string",
      "profile_id": "string",
      "account_id": "string",
      "platform": "string",
      "name": "string",
      "trigger": "string",
      "platform_post_id": "string",
      "post_id": "string",
      "post_title": "string",
      "keywords": [
        "string"
      ],
      "match_mode": "string",
      "exclude_keywords": [
        "string"
      ],
      "typo_tolerance": true,
      "dm_message": "string",
      "dm_message_variations": [
        "string"
      ],
      "buttons": [
        {
          "type": "string",
          "title": "string",
          "url": "https://example.com",
          "payload": "string",
          "phone": "+15551234567"
        }
      ],
      "template": {},
      "quick_replies": [
        {
          "title": "string",
          "payload": "string",
          "image_url": "https://example.com"
        }
      ],
      "dm_media": {
        "type": "string",
        "url": "https://example.com"
      },
      "comment_reply": "string",
      "comment_reply_variations": [
        "string"
      ],
      "public_reply_policy": "string",
      "dm_delay_seconds": 1,
      "comment_reply_delay_seconds": 1,
      "link_tracking": true,
      "click_tag": "string",
      "also_match_in_dms": true,
      "audience": {
        "follower_status": "string",
        "min_follower_count": 1,
        "when_unknown": "string",
        "tap_to_unlock": true
      },
      "follow_gate": {
        "message": "string",
        "button_label": "string",
        "not_following_message": "string"
      }
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Create a comment automation

`POST /comment-automations`

Access: `write` · MCP tool: `create-comment-automation` · Zernio: `POST /v1/comment-automations`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `profile_id` (string)
- `account_id` (string; required)
- `name` (string; required; 1–200 characters)
- `trigger` (string; one of comment, live_comment, story_reply, story_mention)
- `platform_post_id` (string | null; ≤ 255 characters)
- `post_id` (string | null)
- `post_title` (string | null; ≤ 300 characters)
- `keywords` (array of string; ≤ 50 items)
- `match_mode` (string; one of contains, word, exact)
- `exclude_keywords` (array of string; ≤ 50 items)
- `typo_tolerance` (boolean)
- `dm_message` (string | null; ≤ 1000 characters)
- `dm_message_variations` (array of string; ≤ 5 items)
- `buttons` (array of object | null; ≤ 3 items)
  - `buttons[].type` (string; required; one of url, postback, phone)
  - `buttons[].title` (string; required; 1–20 characters)
  - `buttons[].url` (string; ≤ 2048 characters)
  - `buttons[].payload` (string; ≤ 1000 characters)
  - `buttons[].phone` (string; ≤ 32 characters)
- `template` (object | null)
  - `template.type` (string; required; one of generic)
  - `template.image_aspect_ratio` (string; one of horizontal, square)
  - `template.elements` (array of object; required; 1–10 items)
    - `template.elements[].title` (string; required; 1–80 characters)
    - `template.elements[].subtitle` (string; ≤ 80 characters)
    - `template.elements[].image_url` (string; ≤ 2048 characters)
    - `template.elements[].buttons` (array of object; ≤ 3 items)
      - `template.elements[].buttons[].type` (string; required; one of url, postback, phone)
      - `template.elements[].buttons[].title` (string; required; 1–20 characters)
      - `template.elements[].buttons[].url` (string; ≤ 2048 characters)
      - `template.elements[].buttons[].payload` (string; ≤ 1000 characters)
      - `template.elements[].buttons[].phone` (string; ≤ 32 characters)
- `quick_replies` (array of object | null; ≤ 13 items)
  - `quick_replies[].title` (string; required; 1–20 characters)
  - `quick_replies[].payload` (string; required; ≤ 1000 characters)
  - `quick_replies[].image_url` (string; ≤ 2048 characters)
- `dm_media` (object | null)
  - `dm_media.type` (string; required; one of image, video, audio, file)
  - `dm_media.url` (string; required; ≤ 2048 characters)
- `comment_reply` (string | null; ≤ 2000 characters)
- `comment_reply_variations` (array of string; ≤ 5 items)
- `public_reply_policy` (string; one of after_dm, always)
- `dm_delay_seconds` (integer; 0–86400)
- `comment_reply_delay_seconds` (integer; 0–86400)
- `link_tracking` (boolean)
- `click_tag` (string | null; ≤ 64 characters)
- `also_match_in_dms` (boolean)
- `audience` (object | null)
  - `audience.follower_status` (string; one of any, follower, non_follower)
  - `audience.min_follower_count` (integer)
  - `audience.when_unknown` (string; one of send, skip, verify)
  - `audience.tap_to_unlock` (boolean)
- `follow_gate` (object | null)
  - `follow_gate.message` (string; ≤ 640 characters)
  - `follow_gate.button_label` (string; ≤ 20 characters)
  - `follow_gate.not_following_message` (string; ≤ 1000 characters)
- `repeat_policy` (object)
  - `repeat_policy.mode` (string; required; one of once, every_comment)
  - `repeat_policy.cooldown_hours` (integer | null; 1–8760)
- `dedupe_same_text_hours` (integer | null; 1–8760)
- `actions` (object)
  - `actions.like_comment` (boolean)
  - `actions.hide_comment` (boolean)
- `is_active` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/comment-automations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "string",
    "account_id": "string",
    "name": "string",
    "trigger": "comment",
    "platform_post_id": "string"
  }'
```

Response 201:

```json
{
  "object": "comment_automation",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "platform": "string",
  "name": "string",
  "trigger": "string",
  "platform_post_id": "string",
  "post_id": "string",
  "post_title": "string",
  "keywords": [
    "string"
  ],
  "match_mode": "string",
  "exclude_keywords": [
    "string"
  ],
  "typo_tolerance": true,
  "dm_message": "string",
  "dm_message_variations": [
    "string"
  ],
  "buttons": [
    {
      "type": "string",
      "title": "string",
      "url": "https://example.com",
      "payload": "string",
      "phone": "+15551234567"
    }
  ],
  "template": {},
  "quick_replies": [
    {
      "title": "string",
      "payload": "string",
      "image_url": "https://example.com"
    }
  ],
  "dm_media": {
    "type": "string",
    "url": "https://example.com"
  },
  "comment_reply": "string",
  "comment_reply_variations": [
    "string"
  ],
  "public_reply_policy": "string",
  "dm_delay_seconds": 1,
  "comment_reply_delay_seconds": 1,
  "link_tracking": true,
  "click_tag": "string",
  "also_match_in_dms": true,
  "audience": {
    "follower_status": "string",
    "min_follower_count": 1,
    "when_unknown": "string",
    "tap_to_unlock": true
  },
  "follow_gate": {
    "message": "string",
    "button_label": "string",
    "not_following_message": "string"
  },
  "repeat_policy": {
    "mode": "string",
    "cooldown_hours": 1
  },
  "dedupe_same_text_hours": 1,
  "actions": {
    "like_comment": true,
    "hide_comment": true
  },
  "is_active": true,
  "stats": {
    "triggered": 1,
    "dms_sent": 1,
    "dms_failed": 1,
    "unique_contacts": 1,
    "public_replies_sent": 1,
    "tracked_sends": 1,
    "link_clicks": 1,
    "unique_clicks": 1,
    "delivered": 1,
    "read": 1,
    "audience_skipped": 1,
    "follow_gate_sent": 1,
    "follow_gate_passed": 1,
    "follow_gate_failed": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Get a comment automation

`GET /comment-automations/{id}`

Access: `read` · MCP tool: `get-comment-automation` · Zernio: `GET /v1/comment-automations/{automationId}`

### Path parameters

- `id` (string; required; 1–80 characters): commentAutomation id (cau_…)

```bash
curl "https://api.socialit.com/v1/comment-automations/cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment_automation",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "platform": "string",
  "name": "string",
  "trigger": "string",
  "platform_post_id": "string",
  "post_id": "string",
  "post_title": "string",
  "keywords": [
    "string"
  ],
  "match_mode": "string",
  "exclude_keywords": [
    "string"
  ],
  "typo_tolerance": true,
  "dm_message": "string",
  "dm_message_variations": [
    "string"
  ],
  "buttons": [
    {
      "type": "string",
      "title": "string",
      "url": "https://example.com",
      "payload": "string",
      "phone": "+15551234567"
    }
  ],
  "template": {},
  "quick_replies": [
    {
      "title": "string",
      "payload": "string",
      "image_url": "https://example.com"
    }
  ],
  "dm_media": {
    "type": "string",
    "url": "https://example.com"
  },
  "comment_reply": "string",
  "comment_reply_variations": [
    "string"
  ],
  "public_reply_policy": "string",
  "dm_delay_seconds": 1,
  "comment_reply_delay_seconds": 1,
  "link_tracking": true,
  "click_tag": "string",
  "also_match_in_dms": true,
  "audience": {
    "follower_status": "string",
    "min_follower_count": 1,
    "when_unknown": "string",
    "tap_to_unlock": true
  },
  "follow_gate": {
    "message": "string",
    "button_label": "string",
    "not_following_message": "string"
  },
  "repeat_policy": {
    "mode": "string",
    "cooldown_hours": 1
  },
  "dedupe_same_text_hours": 1,
  "actions": {
    "like_comment": true,
    "hide_comment": true
  },
  "is_active": true,
  "stats": {
    "triggered": 1,
    "dms_sent": 1,
    "dms_failed": 1,
    "unique_contacts": 1,
    "public_replies_sent": 1,
    "tracked_sends": 1,
    "link_clicks": 1,
    "unique_clicks": 1,
    "delivered": 1,
    "read": 1,
    "audience_skipped": 1,
    "follow_gate_sent": 1,
    "follow_gate_passed": 1,
    "follow_gate_failed": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Update a comment automation

`PATCH /comment-automations/{id}`

Access: `write` · MCP tool: `update-comment-automation` · Zernio: `PATCH /v1/comment-automations/{automationId}`

### Path parameters

- `id` (string; required; 1–80 characters): commentAutomation id (cau_…)

### Body

- `name` (string; 1–200 characters)
- `trigger` (string; one of comment, live_comment, story_reply, story_mention)
- `platform_post_id` (string | null; ≤ 255 characters)
- `post_id` (string | null)
- `post_title` (string | null; ≤ 300 characters)
- `keywords` (array of string; ≤ 50 items)
- `match_mode` (string; one of contains, word, exact)
- `exclude_keywords` (array of string; ≤ 50 items)
- `typo_tolerance` (boolean)
- `dm_message` (string | null; ≤ 1000 characters)
- `dm_message_variations` (array of string; ≤ 5 items)
- `buttons` (array of object | null; ≤ 3 items)
  - `buttons[].type` (string; required; one of url, postback, phone)
  - `buttons[].title` (string; required; 1–20 characters)
  - `buttons[].url` (string; ≤ 2048 characters)
  - `buttons[].payload` (string; ≤ 1000 characters)
  - `buttons[].phone` (string; ≤ 32 characters)
- `template` (object | null)
  - `template.type` (string; required; one of generic)
  - `template.image_aspect_ratio` (string; one of horizontal, square)
  - `template.elements` (array of object; required; 1–10 items)
    - `template.elements[].title` (string; required; 1–80 characters)
    - `template.elements[].subtitle` (string; ≤ 80 characters)
    - `template.elements[].image_url` (string; ≤ 2048 characters)
    - `template.elements[].buttons` (array of object; ≤ 3 items)
      - `template.elements[].buttons[].type` (string; required; one of url, postback, phone)
      - `template.elements[].buttons[].title` (string; required; 1–20 characters)
      - `template.elements[].buttons[].url` (string; ≤ 2048 characters)
      - `template.elements[].buttons[].payload` (string; ≤ 1000 characters)
      - `template.elements[].buttons[].phone` (string; ≤ 32 characters)
- `quick_replies` (array of object | null; ≤ 13 items)
  - `quick_replies[].title` (string; required; 1–20 characters)
  - `quick_replies[].payload` (string; required; ≤ 1000 characters)
  - `quick_replies[].image_url` (string; ≤ 2048 characters)
- `dm_media` (object | null)
  - `dm_media.type` (string; required; one of image, video, audio, file)
  - `dm_media.url` (string; required; ≤ 2048 characters)
- `comment_reply` (string | null; ≤ 2000 characters)
- `comment_reply_variations` (array of string; ≤ 5 items)
- `public_reply_policy` (string; one of after_dm, always)
- `dm_delay_seconds` (integer; 0–86400)
- `comment_reply_delay_seconds` (integer; 0–86400)
- `link_tracking` (boolean)
- `click_tag` (string | null; ≤ 64 characters)
- `also_match_in_dms` (boolean)
- `audience` (object | null)
  - `audience.follower_status` (string; one of any, follower, non_follower)
  - `audience.min_follower_count` (integer)
  - `audience.when_unknown` (string; one of send, skip, verify)
  - `audience.tap_to_unlock` (boolean)
- `follow_gate` (object | null)
  - `follow_gate.message` (string; ≤ 640 characters)
  - `follow_gate.button_label` (string; ≤ 20 characters)
  - `follow_gate.not_following_message` (string; ≤ 1000 characters)
- `repeat_policy` (object)
  - `repeat_policy.mode` (string; required; one of once, every_comment)
  - `repeat_policy.cooldown_hours` (integer | null; 1–8760)
- `dedupe_same_text_hours` (integer | null; 1–8760)
- `actions` (object)
  - `actions.like_comment` (boolean)
  - `actions.hide_comment` (boolean)
- `is_active` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/comment-automations/cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "trigger": "comment",
    "platform_post_id": "string",
    "post_id": "string",
    "post_title": "string"
  }'
```

Response 200:

```json
{
  "object": "comment_automation",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "platform": "string",
  "name": "string",
  "trigger": "string",
  "platform_post_id": "string",
  "post_id": "string",
  "post_title": "string",
  "keywords": [
    "string"
  ],
  "match_mode": "string",
  "exclude_keywords": [
    "string"
  ],
  "typo_tolerance": true,
  "dm_message": "string",
  "dm_message_variations": [
    "string"
  ],
  "buttons": [
    {
      "type": "string",
      "title": "string",
      "url": "https://example.com",
      "payload": "string",
      "phone": "+15551234567"
    }
  ],
  "template": {},
  "quick_replies": [
    {
      "title": "string",
      "payload": "string",
      "image_url": "https://example.com"
    }
  ],
  "dm_media": {
    "type": "string",
    "url": "https://example.com"
  },
  "comment_reply": "string",
  "comment_reply_variations": [
    "string"
  ],
  "public_reply_policy": "string",
  "dm_delay_seconds": 1,
  "comment_reply_delay_seconds": 1,
  "link_tracking": true,
  "click_tag": "string",
  "also_match_in_dms": true,
  "audience": {
    "follower_status": "string",
    "min_follower_count": 1,
    "when_unknown": "string",
    "tap_to_unlock": true
  },
  "follow_gate": {
    "message": "string",
    "button_label": "string",
    "not_following_message": "string"
  },
  "repeat_policy": {
    "mode": "string",
    "cooldown_hours": 1
  },
  "dedupe_same_text_hours": 1,
  "actions": {
    "like_comment": true,
    "hide_comment": true
  },
  "is_active": true,
  "stats": {
    "triggered": 1,
    "dms_sent": 1,
    "dms_failed": 1,
    "unique_contacts": 1,
    "public_replies_sent": 1,
    "tracked_sends": 1,
    "link_clicks": 1,
    "unique_clicks": 1,
    "delivered": 1,
    "read": 1,
    "audience_skipped": 1,
    "follow_gate_sent": 1,
    "follow_gate_passed": 1,
    "follow_gate_failed": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete a comment automation

`DELETE /comment-automations/{id}`

Access: `write` · MCP tool: `delete-comment-automation` · Zernio: `DELETE /v1/comment-automations/{automationId}`

### Path parameters

- `id` (string; required; 1–80 characters): commentAutomation id (cau_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/comment-automations/cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment_automation",
  "id": "string",
  "deleted": true
}
```

## List comment automation logs

`GET /comment-automations/{id}/logs`

Access: `read` · MCP tool: `list-comment-automation-logs` · Zernio: `GET /v1/comment-automations/{automationId}/logs`

### Path parameters

- `id` (string; required; 1–80 characters): commentAutomation id (cau_…)

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `status` (string)
- `source` (string)

```bash
curl "https://api.socialit.com/v1/comment-automations/cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/logs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "comment_automation_log",
      "id": "string",
      "automation_id": "string",
      "comment_id": "string",
      "commenter_id": "string",
      "commenter_name": "string",
      "commenter_username": "string",
      "comment_text": "string",
      "source": "string",
      "status": "pending",
      "skip_reason": "string",
      "contact_id": "string",
      "audience_outcome": "string",
      "commenter_is_follower": true,
      "commenter_follower_count": 1,
      "dm_message_id": "string",
      "error": "string",
      "platform_error": {
        "code": 1,
        "subcode": 1
      },
      "private_reply_consumed": true,
      "comment_reply_status": "string",
      "comment_reply_error": "string",
      "public_reply_posted_at": "2026-10-13T09:00:00.000Z",
      "like_skipped": "string",
      "hide_skipped": "string",
      "media_error": "string",
      "next_due_at": "2026-10-13T09:00:00.000Z",
      "clicked_at": "2026-10-13T09:00:00.000Z",
      "click_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```


---

Source: https://socialit.com/docs/api-reference/comment-automations/
