Skip to content
reelspanDocs

Engage

AutoDM

Answer every new comment on a post automatically, with a private message to the commenter and/or a public reply, filtered by keywords.

POSTapi.reelspan.com/v1/autodmsTry it →

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}"]
  }'

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');

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');

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.
POSTapi.reelspan.com/v1/autodmsTry it →

Request body

application/json

  • platformstringrequired

    The network

  • userstring

    Profile username (also profile_username)

  • profile_usernamestring
  • post_idstring

    The network’s post id

  • post_urlstring

    Or the post’s link (Instagram, Bluesky)

  • request_idstring

    Or the Reelspan request that published it

  • reply_messagestring

    The private reply: a DM to each commenter (Instagram and Facebook private replies; a DM on X, Bluesky and Mastodon)

  • reply_messagesstring[]

    Public replies under each comment, used in turn; {username} is replaced by the commenter

  • buttonsobject[]

    Link buttons on the private reply (Instagram, Facebook)

    • titlestringrequired
    • urlstringrequired
  • trigger_keywordsstring[] or string

    Answer only comments containing one of these (any case, accents ignored); a list or comma-separated

  • monitoring_intervalinteger

    Minutes between checks, 5 to 1440 (default 15)

  • include_existingboolean

    Also answer comments made in the 7 days before the monitor started

Responses

201 Started

{
  "success": true,
  "monitor": {
    "monitor_id": "string",
    "platform": "string",
    "post_id": "string",
    "status": "running",
    "stats": {
      "total_comments": 0,
      "new_comments": 0,
      "successful_replies": 0,
      "failed_replies": 0
    }
  }
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
GETapi.reelspan.com/v1/autodmsTry it →

Parameters

  • include_inactivestring · query

    truefalse

  • profile_usernamestring · query
  • platformstring · query

Responses

200 Monitors

{
  "success": true,
  "monitors": [
    {
      "monitor_id": "string",
      "platform": "string",
      "post_id": "string",
      "status": "running",
      "stats": {
        "total_comments": 0,
        "new_comments": 0,
        "successful_replies": 0,
        "failed_replies": 0
      }
    }
  ],
  "total_active": 0,
  "total": 0
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
GETapi.reelspan.com/v1/autodms/{monitor_id}Try it →

Parameters

  • monitor_idstring · pathrequired

Responses

200 Monitor

{
  "success": true,
  "monitor": {
    "monitor_id": "string",
    "platform": "string",
    "post_id": "string",
    "status": "running",
    "stats": {
      "total_comments": 0,
      "new_comments": 0,
      "successful_replies": 0,
      "failed_replies": 0
    }
  }
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
GETapi.reelspan.com/v1/autodms/{monitor_id}/logsTry it →

Parameters

  • monitor_idstring · pathrequired
  • limitinteger · query

Responses

200 Logs

{
  "success": true,
  "logs": [
    {
      "comment_id": "string",
      "author": "string",
      "text": "string",
      "kind": "string",
      "success": true,
      "error": "string",
      "at": "string"
    }
  ]
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/autodms/{monitor_id}/pauseTry it →

Parameters

  • monitor_idstring · pathrequired

Responses

200 Done

{
  "success": true,
  "monitor": {
    "monitor_id": "string",
    "platform": "string",
    "post_id": "string",
    "status": "running",
    "stats": {
      "total_comments": 0,
      "new_comments": 0,
      "successful_replies": 0,
      "failed_replies": 0
    }
  }
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/autodms/{monitor_id}/resumeTry it →

Parameters

  • monitor_idstring · pathrequired

Responses

200 Done

{
  "success": true,
  "monitor": {
    "monitor_id": "string",
    "platform": "string",
    "post_id": "string",
    "status": "running",
    "stats": {
      "total_comments": 0,
      "new_comments": 0,
      "successful_replies": 0,
      "failed_replies": 0
    }
  }
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/autodms/{monitor_id}/stopTry it →

Parameters

  • monitor_idstring · pathrequired

Responses

200 Done

{
  "success": true,
  "monitor": {
    "monitor_id": "string",
    "platform": "string",
    "post_id": "string",
    "status": "running",
    "stats": {
      "total_comments": 0,
      "new_comments": 0,
      "successful_replies": 0,
      "failed_replies": 0
    }
  }
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/autodms/{monitor_id}/checkTry it →

Parameters

  • monitor_idstring · pathrequired

Responses

200 Done

{
  "success": true,
  "monitor": {
    "monitor_id": "string",
    "platform": "string",
    "post_id": "string",
    "status": "running",
    "stats": {
      "total_comments": 0,
      "new_comments": 0,
      "successful_replies": 0,
      "failed_replies": 0
    }
  }
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
DELETEapi.reelspan.com/v1/autodms/{monitor_id}Try it →

Parameters

  • monitor_idstring · pathrequired

Responses

200 Deleted

{
  "success": true
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

Something unclear or missing? Write to [email protected] and we’ll fix the page.