> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a comment automation

> Create a new comment automation that posts comments through a connected account.

Creates a comment automation. New automations should be created with `status: 0` (paused) and activated later with the [update](https://reach-owl.mintlify.site/update-comment-automation.md) endpoint.

## Headers

**Authorization** `string` *required*

Bearer token. Format: `Bearer {token}`.

**Content-Type** `string` *required*

Must be `application/json`.

## Body

**name** `string` *required*

Name of the comment automation.

**platform** `string` *required*

Social platform. Currently `facebook` is supported.

**executor\_ids** `integer[]` *required*

IDs of the connected accounts that post comments. Use the `id` values from `GET /api/v1/app-states`.

**comments** `object[]` *required*

Comment content to post.

**properties**

**text** `string` *required*

Comment text. Supports the `{{first_name}}` placeholder.

**schedule** `object[]` (default: \[])

Time windows when comments may be posted.

**properties**

**day** `string` *required*

Day name, for example `Monday`.

**start\_time** `string` *required*

Start time in `HH:MM` format.

**end\_time** `string` *required*

End time in `HH:MM` format.

**limit** `integer` (default: 30)

Maximum comments posted per day.

**status** `integer` (default: 0)

`0` = paused, `1` = running.

## Response

**data** `object`

The created comment automation.

**properties**

**id** `integer`

Unique comment automation ID.

**name** `string`

Name of the comment automation.

**status** `integer`

`0` = paused, `1` = running.

**limit** `integer`

Maximum comments posted per day.

```bash cURL theme={null}
curl -X POST "https://reachowl.com/api/v1/comment-automations" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Post Engagement",
    "platform": "facebook",
    "executor_ids": [101],
    "comments": [
      { "text": "Great post, {{first_name}}! Thanks for sharing." }
    ],
    "schedule": [
      { "day": "Monday", "start_time": "09:00", "end_time": "17:00" }
    ],
    "limit": 30,
    "status": 0
  }'
```

```json 201 theme={null}
{
  "data": {
    "id": 12,
    "name": "Post Engagement",
    "status": 0,
    "limit": 30
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.