An AutoDM monitor watches one post and answers each new comment: privately, with a direct message to the commenter (reply_message), in public under the comment (reply_messages), or both. Add trigger_keywords to answer only comments that ask for something, like "LINK" or "price".
A monitor runs for 15 days, checking the post every monitoring_interval minutes. Starting, pausing and stopping need a key with the publish scope; reading needs read.
Start a monitor
curl -X POST https://api.reelspan.com/v1/autodms \
-H "Authorization: Bearer $REELSPAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "instagram",
"user": "my-brand",
"request_id": "9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1",
"trigger_keywords": ["link", "price"],
"reply_message": "Here you go!",
"buttons": [{ "title": "Shop now", "url": "https://example.com/shop" }],
"reply_messages": ["Sent you a DM, {username}!", "Check your messages, {username}"]
}'import { Reelspan } from 'reelspan';
const reelspan = new Reelspan();
const { monitor } = await reelspan.autodms.start({
platform: 'instagram',
user: 'my-brand',
requestId: '9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1',
triggerKeywords: ['link', 'price'],
replyMessage: 'Here you go!',
buttons: [{ title: 'Shop now', url: 'https://example.com/shop' }],
replyMessages: ['Sent you a DM, {username}!', 'Check your messages, {username}'],
});from reelspan import Reelspan
reelspan = Reelspan()
monitor = reelspan.autodms.start(
"instagram",
"my-brand",
request_id="9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1",
trigger_keywords=["link", "price"],
reply_message="Here you go!",
buttons=[{"title": "Shop now", "url": "https://example.com/shop"}],
reply_messages=["Sent you a DM, {username}!", "Check your messages, {username}"],
)["monitor"]The answer is 201 with the monitor:
{
"success": true,
"monitor": {
"monitor_id": "adm_Rt5Yu8Io1Pa4Sd7Fg0Hj",
"platform": "instagram",
"post_id": "17912345678901234",
"post_url": null,
"reply_message": "Here you go!",
"reply_messages": ["Sent you a DM, {username}!", "Check your messages, {username}"],
"buttons": [{ "title": "Shop now", "url": "https://example.com/shop" }],
"trigger_keywords": ["link", "price"],
"monitoring_interval": 15,
"include_existing": false,
"status": "running",
"is_active": true,
"is_running": true,
"is_paused": false,
"stop_reason": null,
"stats": { "total_comments": 0, "new_comments": 0, "successful_replies": 0, "failed_replies": 0 },
"created_at": "2026-12-01T09:00:00.000Z",
"last_check": null,
"next_check": "2026-12-01T09:00:00.000Z",
"paused_at": null,
"stopped_at": null,
"expires_at": "2026-12-16T09:00:00.000Z"
}
}| Field | |
|---|---|
platform, user |
The network and the profile (also profile_username). |
request_id, post_id or post_url |
The post to watch, named as for comments. An Instagram link is turned into its media id when the monitor starts. |
reply_message |
The private reply, up to 1,000 characters: a private reply to the comment on Instagram and Facebook, a direct message on X, Bluesky and Mastodon. |
buttons |
Up to 3 link buttons on the private reply (Instagram, Facebook). |
reply_messages |
Up to 5 public replies, used in turn so answers don't all read the same. {username} becomes the commenter's name. |
trigger_keywords |
Answer only comments containing one of these: a list or a comma-separated string. Case and accents are ignored ("precio" matches "Précio"). Leave it out to answer every comment. |
monitoring_interval |
Minutes between checks, 5 to 1440 (default 15). |
include_existing |
Also answer comments made in the 7 days before the monitor started. By default only new ones are answered. |
Send reply_message, reply_messages or both. The monitor's first read checks the post and the account's permission before it is created, so a mistake fails straight away.
Limits
- A monitor answers up to 25 comments a check; a bigger backlog is picked up a minute later rather than at the next interval.
- A profile gets up to 500 answers a day across its monitors, and can start 10 monitors a day.
- A workspace runs up to 50 monitors at once (running or paused), and a post has one at a time.
- Comments older than 7 days are left alone (Instagram allows private replies for 7 days).
Which networks
Monitors work where Reelspan can read comments: Instagram, Facebook, Threads, YouTube, X, Bluesky, Mastodon and Reddit, among others. Public replies work on all of them. Private replies need direct messages: Instagram and Facebook (as private replies to the comment), X, Bluesky, Mastodon and Reddit. On a network without them, reply_message gets 400 private_reply_not_supported; use reply_messages.
Instagram and Facebook private replies need the instagram_manage_messages and pages_messaging permissions, and reading their comments needs instagram_manage_comments and pages_read_user_content. See Permissions.
List and read monitors
GET /v1/autodms lists the running and paused monitors, newest first. include_inactive=true adds stopped and expired ones; profile_username and platform narrow it.
const { monitors, total_active } = await reelspan.autodms.list({ user: 'my-brand' });
const { monitor } = await reelspan.autodms.get('adm_Rt5Yu8Io1Pa4Sd7Fg0Hj');monitors = reelspan.autodms.list(user="my-brand")["monitors"]stats counts what the monitor has seen and done: total_comments on the post, new_comments at the last check, and successful_replies and failed_replies.
Logs
GET /v1/autodms/{monitor_id}/logs lists what the monitor did with each comment, newest first. limit is 1 to 500 (default 100).
{
"success": true,
"logs": [
{ "comment_id": "17998765432109876", "author": "a_fan", "text": "LINK please!", "kind": "private_reply", "success": true, "error": null, "at": "2026-12-01T09:15:02.000Z" },
{ "comment_id": "17998765432109876", "author": "a_fan", "text": "LINK please!", "kind": "public_reply", "success": true, "error": null, "at": "2026-12-01T09:15:02.000Z" },
{ "comment_id": "17998765432100001", "author": "another_fan", "text": "Love it", "kind": "skipped", "success": true, "error": "no keyword", "at": "2026-12-01T09:15:01.000Z" }
]
}kind is private_reply, dm, public_reply or skipped. A failed answer has success: false and the network's error.
Pause, resume, stop, check, delete
| Request | Does |
|---|---|
POST /v1/autodms/{monitor_id}/pause |
Stops checking until resumed. Comments made meanwhile are answered on resume. |
POST /v1/autodms/{monitor_id}/resume |
Checks again from now. |
POST /v1/autodms/{monitor_id}/stop |
Stops it for good (stop_reason: "stopped_by_user"). Start a new monitor to watch the post again. |
POST /v1/autodms/{monitor_id}/check |
Checks a running monitor's post now instead of at the next interval; result says how many comments it answered. |
DELETE /v1/autodms/{monitor_id} |
Deletes the monitor and its logs. |
A stopped or expired monitor can't be paused or resumed: 409 AUTODM_ENDED.
await reelspan.autodms.pause('adm_Rt5Yu8Io1Pa4Sd7Fg0Hj');
await reelspan.autodms.resume('adm_Rt5Yu8Io1Pa4Sd7Fg0Hj');
await reelspan.autodms.stop('adm_Rt5Yu8Io1Pa4Sd7Fg0Hj');reelspan.autodms.pause("adm_Rt5Yu8Io1Pa4Sd7Fg0Hj")
reelspan.autodms.resume("adm_Rt5Yu8Io1Pa4Sd7Fg0Hj")
reelspan.autodms.stop("adm_Rt5Yu8Io1Pa4Sd7Fg0Hj")Webhooks
Each comment a monitor answers is also sent as a comment_received webhook with its monitor_id, when your endpoint subscribes to it.
Errors
| Status | error_code |
When |
|---|---|---|
| 400 | platform_not_supported, private_reply_not_supported, INVALID_REQUEST |
The network can't do this, or neither reply was sent. |
| 404 | NOT_FOUND, profile_platform_mapping_invalid |
No such monitor, account or post. |
| 409 | AUTODM_EXISTS, AUTODM_ENDED, AUTODM_NOT_RUNNING, reauth_required, permission_reconnect |
The post already has a monitor (its id is in monitor_id), the monitor has ended or isn't running, or the account must be reconnected. |
| 429 | AUTODM_LIMIT, AUTODM_DAILY_LIMIT |
Too many monitors running, or started today. |
| 502 | The network's code | The network refused. |