groniz integrations: list, settings, and trigger commands

The groniz integrations command group lets you inspect every social channel connected to your Groniz account. Use list to discover integration IDs, settings to fetch the exact fields and character limits a platform requires before posting, and trigger to invoke dynamic platform-specific tools.

`groniz integrations list`

Returns a JSON array of all integrations connected to your account. Each object contains the integration’s unique ID, human-readable name, and provider type.

groniz integrations list

Example output

[
  {
    "id": "int_abc123",
    "name": "My X Account",
    "provider": "x"
  },
  {
    "id": "int_def456",
    "name": "Company LinkedIn Page",
    "provider": "linkedin_page"
  },
  {
    "id": "int_ghi789",
    "name": "r/myprogramming subreddit",
    "provider": "reddit"
  }
]

Extract only integration IDs with jq

groniz integrations list | jq '.[].id'

Common `provider` values

`provider`	Platform
`x`	X (Twitter)
`linkedin_page`	LinkedIn Page
`linkedin_profile`	LinkedIn Personal Profile
`instagram`	Instagram
`facebook`	Facebook Page
`threads`	Threads
`reddit`	Reddit
`bluesky`	Bluesky
`mastodon`	Mastodon
`discord`	Discord
`telegram`	Telegram
`pinterest`	Pinterest
`youtube`	YouTube
`tiktok`	TikTok

`groniz integrations settings <id>`

Returns the JSON settings schema for a specific integration. The schema describes every field the platform requires or accepts when creating a post, including character limits and enumerated options.

groniz integrations settings int_abc123

Example — X integration

{
  "who_can_reply_post": {
    "type": "string",
    "enum": ["everyone", "mentioned_users", "subscribers"],
    "default": "everyone",
    "description": "Who can reply to this post"
  },
  "characterLimit": 280
}

Example — Reddit integration

{
  "subreddit": {
    "type": "string",
    "required": true,
    "description": "Target subreddit (without r/ prefix)"
  },
  "title": {
    "type": "string",
    "required": true,
    "description": "Post title"
  },
  "flair": {
    "type": "string",
    "required": false,
    "description": "Flair tag to apply to the post"
  }
}

Always call groniz integrations settings <id> before posting to a platform type you haven’t used before. Platform schemas differ significantly — hardcoding field assumptions leads to 400 errors that can be difficult to debug.

`groniz integrations trigger`

Invokes a dynamic tool exposed by a specific integration. Tools vary by provider and can include actions such as fetching available subreddits, retrieving board lists, or other platform-specific operations.

--integration-id

string

required

The ID of the integration whose tool you want to invoke.

--tool

string

required

The name of the tool to run. Available tool names are platform-dependent.

--params

string

Parameters to pass to the tool, encoded as a JSON string.

groniz integrations trigger \
  --integration-id int_ghi789 \
  --tool list_subreddits \
  --params '{"limit": 10}'

Commands

groniz integrations: list, settings, and trigger commands