Skip to content

suggest_x_accounts

posts:writeuses credits

Find X accounts the user's target audience follows, so replying to them early puts the user in front of that audience. Built from the brand profile and strategy and checked against X (handle, name, followers, bio, and why). A fresh search runs at most once a week and costs a little; otherwise the saved list comes back free (cached true).

Show the list, let the user pick, then save the picks as a people feed with update_engagement_settings (up to 15 handles per feed).

Input

This tool takes no input.

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": "suggest_x_accounts",
"arguments": {}
}
}

Same action over the REST API

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