# Pendo

> Query Pendo product analytics and in-app guides - run aggregation queries and list features, pages, guides, reports, and metadata schemas.

Lets an agent query your Pendo product-analytics account: run aggregation queries (Pendo's core analytics API), list tagged features, pages, and guides, list and run saved reports, and read the visitor/account metadata schemas used to build filters.

## What it can do

| Method | What it does |
| --- | --- |
| `pendo_aggregation` | Run an Aggregation query - the core Pendo analytics API. Provide a pipeline of stages whose first stage names a source (events, featureEvents, pageEvents, guideEvents, visitors, accounts). |
| `pendo_features_list` | List tagged features. |
| `pendo_pages_list` | List tagged pages. |
| `pendo_guides_list` | List in-app guides with state, audience, and metrics. |
| `pendo_reports_list` | List saved reports. |
| `pendo_report_run` | Run a saved report and return its results as CSV. |
| `pendo_metadata_schema` | Get the metadata schema for `visitor` or `account` (available fields and types). |
| `pendo_request` | Generic passthrough to any Pendo endpoint for full API coverage. |

## How to get credentials

1. Sign in to Pendo and open **Settings → Integrations → Integration Keys** ([app.pendo.io/admin/integrationkeys](https://app.pendo.io/admin/integrationkeys)).
2. Create an integration key (or copy an existing one). Read-only is enough for the actions above; pick the access level that matches your needs.
3. Copy the key and paste it into FlyMyAI.

The key is sent on every request as the `x-pendo-integration-key` header.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `PENDO_INTEGRATION_KEY` | Pendo → Settings → Integrations → Integration Keys |

## Troubleshooting

- **`401` / `403`** - the integration key is wrong, revoked, or lacks the access level for the endpoint. Re-copy or create a new key under Integration Keys.
- **`pendo_aggregation` returns an error about the pipeline** - the first pipeline stage must include a valid `source`. See the [Aggregations docs](https://engageapi.pendo.io) for the pipeline DSL.
- **`pendo_report_run` returns CSV text, not JSON** - that is expected; report results come back as CSV.

## Links

- [Pendo Engage API reference](https://engageapi.pendo.io)
- [Integration keys](https://app.pendo.io/admin/integrationkeys)