Integrations - Groniz Documentation

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 getFlairs -d '{"subreddit":"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" getFlairs -d '{"subreddit":"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"

​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