> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PostgreSQL

> Set up and use the PostgreSQL integration with Hyper AI

Auth type: API

<Info>
  See overall connection and security guidance: [App Integrations](/integrations/overview).
</Info>

## Connect PostgreSQL

1. Go to Settings → Apps in Hyper
2. Select PostgreSQL → Connect New
3. Provide host, port, database, username, and password; optionally use SSL

## Common capabilities

* Read and write data with parameterized queries
* Generate reports and summaries into Sheets/Drive

## Use in Chat

Enable PostgreSQL and ask the agent to run safe, parameterized queries. Avoid raw input in queries.

## Use in Agents/Flows

Add PostgreSQL actions to fetch/update data and pass variables between steps.

## Troubleshooting

* Connection refused: check networking/VPC and allowlist Hyper’s egress IPs
* Permission denied: verify DB role privileges