Skip to main content
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.
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.
The tools of every network, and what each returns, are on Provider tools.
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

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Path Parameters

id
string
required

The channel's id, from List channels

Body

application/json
methodName
string
required

The tool method name, as returned by the integration settings endpoint

data
object

The tool's input, keyed as in its dataSchema. Send {} for a tool that takes none

Response

The tool's result

output
any

The result. Its shape depends on the tool

Last modified on September 23, 2026