Integrations

Every post has to name the channel it goes to. These commands give you the channel IDs, the settings schema each network enforces, and the helper tools it offers.

Listing Integrations

List all connected social media accounts to get their IDs:

postqueen integrations:list

A JSON array of your channels comes back. The id and identifier fields are what the rest of these commands take.

Use jq to extract specific fields:

postqueen integrations:list | tail -n +2 | jq '.[] | {id, identifier}'

postqueen integrations:list | tail -n +2 | jq '.[] | select(.identifier=="reddit")'

Filtering by Group

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

postqueen integrations:list --group "customer-id"

Listing Groups

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

postqueen 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=$(postqueen integrations:groups | tail -n +2 | jq -r '.[] | select(.name=="My Company") | .id')
postqueen 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:

postqueen integrations:settings <integration-id>

Run this before posting to a network for the first time. It is faster than reading a provider page, and it answers the question that actually blocks you: which fields will be refused if you leave them out.

Four things come back, wrapped in an output object:

Field	What it is
`rules`	The network’s own constraints in plain language
`maxLength`	Character limit for the post content. For channels where a verified account gets more room, this is already the number that applies to yours
`settings`	The schema for `--settings`: which fields exist, which are required, and what each accepts. Channels with nothing to configure return the string `No additional settings required` instead of an object
`tools`	Helper tools this channel offers. Pass `methodName` to `integrations:trigger`. An empty array means this network has none

Example response for a Pinterest channel

{
  "output": {
    "rules": "Pinterest requires at least one media, if posting a video, you must have two attachment, one for video, one for the cover picture, When posting a video, there can be only one, if posting images, there can be maximum 5",
    "maxLength": 500,
    "settings": {
      "type": "object",
      "properties": {
        "board": { "type": "string", "description": "board must be an id" },
        "title": { "type": "string", "maxLength": 100 },
        "link": { "type": "string", "format": "url" },
        "dominant_color": { "type": "string" }
      },
      "required": ["board"]
    },
    "tools": [
      { "methodName": "boards", "description": "List of boards", "dataSchema": [] }
    ]
  }
}

settings is a JSON Schema document, generated from that provider’s own validation rules, so required fields are listed in a required array rather than flagged on each property. The block above is abridged; a real response carries every constraint the network enforces.

Triggering Tools

Some platforms offer dynamic tools, for example fetching Reddit flairs, Pinterest boards, or Discord channels. These return data you need when constructing platform-specific settings.

postqueen integrations:trigger <integration-id> <method-name>

Pass additional data with -d:

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

Examples

Reddit: flairs and restrictions for a subreddit

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

Reddit: search subreddits by keyword

postqueen integrations:trigger reddit-id subreddits -d '{"word":"programming"}'

Discord: list channels

postqueen integrations:trigger discord-id channels

Whop: list companies

postqueen integrations:trigger whop-id companies

Pinterest: list boards

postqueen integrations:trigger pinterest-id boards

Instagram: search audio for a Reel

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

Facebook Business-linked channels only. An empty q returns trending audio.

Provider Tools lists every tool each network offers, and what it gives back, without needing a connected channel to ask.

Discovery Workflow

When working with a new platform, follow this workflow:

Find the integration ID

INTEGRATION_ID=$(postqueen integrations:list | tail -n +2 | jq -r '.[] | select(.identifier=="reddit") | .id')

Check what settings and tools are available

postqueen integrations:settings "$INTEGRATION_ID"

Use tools to fetch dynamic data

Flairs, boards, channels: whatever that network needs you to name.

postqueen integrations:trigger "$INTEGRATION_ID" restrictions -d '{"subreddit":"/r/programming"}'

Create a post with the discovered settings

postqueen posts:create \
  -c "My post" \
  -s "2026-08-01T09:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"/r/programming","title":"Post Title","type":"text","is_flair_required":false}}]}' \
  -i "$INTEGRATION_ID"

Next steps

Provider tools

Every helper tool each network exposes, what it takes and what it gives back.

Ready-made commands

A worked example per network, settings included.

Schedule the post

Threads, drafts, campaigns and the JSON file format.

The settings endpoint

The same schema over HTTP, without the CLI.

Command line

SDK

Listing Integrations

Filtering by Group

Listing Groups

Getting Settings

Triggering Tools

Examples

Discovery Workflow

Next steps

Provider tools

Ready-made commands

Schedule the post

The settings endpoint

​Listing Integrations

​Filtering by Group

​Listing Groups

​Getting Settings

​Triggering Tools

​Examples

​Discovery Workflow

​Next steps

Provider tools

Ready-made commands

Schedule the post

The settings endpoint

Listing Integrations

Filtering by Group

Listing Groups

Getting Settings

Triggering Tools

Examples

Discovery Workflow

Next steps