update_engagement_settings

posts:write

Choose whose posts the reply inbox watches: watchHandles is the full list of X handles in the user's community (up to 10, e.g. ['levelsio', 'marc_louvion']) and keywords the full list of topics (up to 5). Each list you pass replaces the old one, so include the ones to keep. feeds are saved Engage feeds (up to 5) so the user can reply early to new posts: each has a name and a source of 'keywords' (keywords, up to 5), 'list' (listId: a public X list's id or link) or 'people' (handles, up to 15, e.g. their contacts). minFollowers and maxFollowers (optional) keep only posts whose author's follower count is in that range, e.g. 500 to 5000 to find peers and potential customers rather than big accounts.

Pass the full feeds list, keeping each existing feed's id; enabled false pauses one. redditKeywords are phrases people write on Reddit when they have the problem the user's product solves (e.g. 'struggling to post consistently'), not product names; subreddits narrow where to listen (empty means all of Reddit); redditExcludeTerms skip threads mentioning them.

An empty redditKeywords list turns Reddit listening off. suggest_reddit_listening proposes both from the brand and strategy. autoRefresh true checks X and Reddit and drafts replies a few times a day, which costs X reads, web searches and AI credits.

Confirm the lists with the user first. Nothing is ever posted automatically.

Input

• watchHandlesarray<string & string>

  at most 10 items

• keywordsarray<string>

  at most 5 items

• autoRefreshboolean
• redditKeywordsarray<string>

  at most 8 items

• subredditsarray<string & string>

  at most 10 items

• redditExcludeTermsarray<string>

  at most 10 items

• feedsarray<object>

  at most 5 items

  Item fields

  • namestringrequired

    min length 1 · max length 40

  • sourcestringrequired

    one of keywords, list, people

  • idstring

    min length 1 · max length 64

  • keywordsarray<string>

    at most 5 items · default []

  • listIdstring & string | null

    default null

  • handlesarray<string & string>

    at most 15 items · default []

  • minFollowersinteger | null

    default null

  • maxFollowersinteger | null

    default null

  • enabledboolean

    default true

Permission

Needs the posts:write scope: create drafts. It changes your workspace, so clients may ask you to confirm each call.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_engagement_settings",
    "arguments": {}
  }
}

Same action over the REST API

The tool runs PUT /v1/orgs/{orgId}/engagement/settings as the signed-in user, with the same validation, approval rules and limits. See it in the Reply inbox API reference.