Integrations

Listing Integrations

List all connected social media accounts to get their IDs:

groniz integrations list

This returns a JSON array of integrations. Use jq to extract specific fields:

# Get just the IDs and platform names
groniz integrations list | jq '.[] | {id, identifier}'

# Find a specific platform
groniz integrations list | jq '.[] | select(.identifier=="reddit")'

Filtering by Group

If your channels are organized into groups (customers), filter the list to a single group with --group:

groniz integrations list --group "customer-id"

Listing Groups

List all groups (customers) for your organization to get their IDs:

groniz integrations groups

This returns a JSON array of {id, name} objects. Use a group’s id with integrations list --group to filter channels:

# Find a group by name, then list its integrations
GROUP_ID=$(groniz integrations groups | jq -r '.[] | select(.name=="My Company") | .id')
groniz integrations list --group "$GROUP_ID"

Getting Settings

Each platform has its own settings schema with character limits, required fields, and available options. Retrieve it with:

groniz integrations settings <integration-id>

The response tells you:

What fields are available (title, privacy level, subreddit, etc.)
Which fields are required
Character limits and validation rules
Available dynamic tools you can trigger

Always check integrations settings before posting to a new platform to understand what settings are available.

Triggering Tools

Some platforms expose dynamic tools — for example, fetching Reddit flairs, YouTube playlists, or LinkedIn company pages. These return data you need when constructing platform-specific settings.

groniz integrations trigger <integration-id> <method-name>

Pass additional data with -d:

groniz integrations trigger <integration-id> <method-name> -d '{"key":"value"}'

Examples

Get Reddit flairs for a subreddit:

groniz integrations trigger reddit-id restrictions -d '{"subreddit":"/r/programming"}'

Get YouTube playlists:

groniz integrations trigger youtube-id getPlaylists

Get LinkedIn company pages:

groniz integrations trigger linkedin-id getCompanies

Get Pinterest boards:

groniz integrations trigger pinterest-id getBoards

Search Instagram audio for a Reel (Facebook Business-linked channels only, empty q returns trending audio):

groniz integrations trigger instagram-id audioSearch -d '{"q":"summer vibes","type":"music"}'

Discovery Workflow

When working with a new platform, follow this workflow:

# 1. Find the integration ID
INTEGRATION_ID=$(groniz integrations list | jq -r '.[] | select(.identifier=="reddit") | .id')

# 2. Check what settings and tools are available
groniz integrations settings "$INTEGRATION_ID"

# 3. Use tools to fetch dynamic data (e.g., flairs)
groniz integrations trigger "$INTEGRATION_ID" restrictions -d '{"subreddit":"/r/programming"}'

# 4. Create a post with the discovered settings
groniz posts create \
  -c "My post" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Post Title","type":"text"}}]}' \
  -i "$INTEGRATION_ID"

Getting Started

CLI

MCP

Troubleshooting

Help

Listing Integrations

Filtering by Group

Listing Groups

Getting Settings

Triggering Tools

Examples

Discovery Workflow

​Listing Integrations

​Filtering by Group

​Listing Groups

​Getting Settings

​Triggering Tools

​Examples

​Discovery Workflow

Listing Integrations

Filtering by Group

Listing Groups

Getting Settings

Triggering Tools

Examples

Discovery Workflow