---
name: vista-profiles
description: Lists and filters Vista Social connected profiles and groups. Use when finding profile IDs, checking which social accounts are connected, filtering profiles by group, or resolving a profile name to its ID.
allowed-tools: Bash(vista *)
argument-hint: "[--query <name>] [--group-id <id>]"
---

# Vista Social — Profiles & Groups

Use these commands to discover connected social accounts and their IDs.

## Setup

Requires `VISTA_SOCIAL_API_KEY` in the project's `.env` file. If not set, commands will fail with a clear error.

To get your API key: go to https://vistasocial.com/settings/preferences/integrations and copy your API key, then add it to `.env`:

```
VISTA_SOCIAL_API_KEY=your_key_here
```

## Commands

### List Profiles

```bash
vista profiles [--query <name>] [--group-id <id>] [--format json|table] [--verbose]
```

Returns all connected social profiles. Output includes `id`, `name`, `network`. Supports name search with `--query` and group filtering with `--group-id`. Use `--format table` for human-readable output or `--format json` (default) for piping.

### List Groups

```bash
vista groups [--query <name>] [--format json|table] [--verbose]
```

Returns profile groups. Output includes `id`, `name`, `type` (CLIENT | PROJECT). Use group IDs with `--group-id` on the profiles command to filter profiles by group.

## Common Patterns

```bash
# Find profiles by name
vista profiles --query "Facebook" --format table

# Get a specific profile ID for other commands
vista profiles --query "Acme Instagram" | jq '.[0].id'

# List all groups
vista groups

# Filter profiles by group
vista profiles --group-id "123"
```

## Additional Resources

- Full parameter reference and response schemas: [reference.md](reference.md)