---
title: "Trigger an integration tool"
method: POST
path: "/integration-trigger/{id}"
tags: ["Integrations"]
---

# Trigger an integration tool

`POST /integration-trigger/{id}`

Executes a provider-specific tool on a connected channel, for example searching Instagram audio for Reels, listing Discord channels, or fetching Reddit flairs. Discover available tools with the integration settings endpoint.

## Path parameters

- `id` string, required

## Request body

- object
  - `methodName` string, required — The tool method name, as returned by the integration settings endpoint
  - `data` object — Key-value parameters for the tool

## Response `200`

Tool executed successfully

- object
  - `output` unknown

## Other responses

- `401` — Channel disconnected due to expired token
- `404` — Integration or tool not found

---

[API](https://skmtc.net/postiz/apis/postiz-public-api.md) · [All operations](https://skmtc.net/postiz/apis/postiz-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postiz/postiz-public-api/revisions/91e98b6af585/schema)