Trigger a tool
Trigger a tool
Run a network’s helper tool on a channel, such as listing WordPress post types or Hashnode publications.
POST
Trigger a tool
Some settings take an id you cannot guess: a WordPress post type, a Hashnode publication, a Lemmy community. The network’s helper tools look them up for you.
The tools of every network, and what each returns, are on Provider tools.
1
Find the tool
Call Get a channel’s settings. Its
tools list gives each tool’s methodName, what it does, and its inputs in dataSchema.2
Run it
Send
methodName, and data keyed as in dataSchema. Send "data": {} for a tool with no inputs.3
Use the result
Put the id you picked into the post’s
settings, such as "type": "posts" for WordPress.When the network refuses the call, the answer is a plain
500 Unexpected error, without the network’s own message. Check data against the tool’s dataSchema first. 401 Channel disconnected due to expired token means the channel has to be connected again.Authorizations
Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.
Path Parameters
The channel's id, from List channels
Body
application/json
Response
The tool's result
The result. Its shape depends on the tool
Last modified on September 23, 2026