---
title: "Agent: Review to Post"
summary: "Turns your best new reviews into short thank-you posts and publishes them automatically."
updated: "2026-09-30"
status: stable
origin: official
url: "https://swooshconnect.com/docs/agent-review-to-post/"
---

# Agent: Review to Post

Turns your best new reviews into short thank-you posts and publishes them automatically.

## For AI agents

- Runs every 6 hours (0 */6 * * *) from supabase/functions/run/index.ts in the customer's Supabase project.
- Only call SwooshConnect's API, never a platform directly: read with `inbox_list` and publish with `create_post`.
- This publishes publicly. It quotes at most 20 words of a review and the reviewer's first name only.
- Table: shared_reviews. Never share the same review twice.
- Only reviews at or above MIN_RATING (5 by default) are used, up to MAX_POSTS_PER_RUN per account per run (1 by default).
- Keep imports with a .ts extension; never ship test files in the function folder.
- Never log a secret or review text.

## What it does

Every 6 hours it checks your connected accounts' inboxes for new reviews rated MIN_RATING stars or higher (5 by default) and turns the best new one into a short thank-you post, published automatically. It posts up to MAX_POSTS_PER_RUN per account per run (1 by default).

The post quotes a short excerpt of 20 words or fewer and the reviewer's first name only. Never their full name or any other detail.

## Schedule

```text
0 */6 * * *
```

## Settings

| Setting | Label in the portal | Visibility |
| --- | --- | --- |
| AI_MODEL_PROVIDER | AI provider (anthropic or openai) | Choice |
| AI_MODEL_KEY | Your AI model key | Secret |

## Tables it creates

```text
shared_reviews   every review already turned into a post: item_id, account_id, shared_at, external_id
```

Open shared_reviews in your Supabase Table Editor to see every review this agent has shared. A review in that table is never shared again.

## How to extend

- Change MIN_RATING or MAX_POSTS_PER_RUN at the top of `supabase/functions/run/index.ts`.
- Edit the prompt to change the tone or the post format.
- Add your own image generator and Supabase Storage, then pass imageUrl to the posts call.

## Safety notes

> **Must:** This agent publishes publicly, on its own, using real customers' words. There is no approval step. Check your reviewers are fine being quoted by first name before you turn it on.

> **Never:** Do not call a platform directly, and do not log keys or review text. Reach your accounts only through SwooshConnect's API.

See [Agents](https://swooshconnect.com/docs/agents/) for deploying, refreshing and removing.