name: podium-core-workflow-b
description: "Podium core workflow b \u2014 business messaging and communication platform
\ integration.\nUse when working with Podium API for messaging, reviews, or payments.\n
Trigger with phrases like "podium core workflow b", "podium-core-workflow-b"
.\n"
allowed-tools: Read, Write, Edit, Bash(npm:), Bash(curl:), Grep
version: 2.0.0
license: MIT
author: Jeremy Longshore jeremy@intentsolutions.io
tags:
- saas
- podium
- messaging
- reviews
- payments compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
Podium Core Workflow B
Overview
Manage reviews and payments with Podium: request reviews from customers, track review status, and create payment invoices.
Prerequisites
- Completed
podium-core-workflow-a(messaging) - Reviews and Payments features enabled in Podium account
Instructions
Step 1: Request a Review
// Send a review request to a customer
const { data } = await podium.post(`/locations/${locationId}/review-invitations`, {
data: {
attributes: {
'contact-phone': '+15551234567',
'customer-name': 'Jane Doe',
},
},
});
console.log(`Review invitation sent: ${data.data.id}`);
Step 2: List Reviews
const { data } = await podium.get(`/locations/${locationId}/reviews`);
for (const review of data.data) {
console.log(` ${review.attributes.rating}/5 — ${review.attributes.body}`);
}
Step 3: Create a Payment Invoice
const { data } = await podium.post(`/locations/${locationId}/invoices`, {
data: {
attributes: {
'contact-phone': '+15551234567',
amount: 5000, // $50.00 in cents
description: 'Service invoice #1234',
},
},
});
console.log(`Invoice created: ${data.data.id}, amount: $${data.data.attributes.amount / 100}`);
Output
- Review invitations sent to customers
- Review listing with ratings and content
- Payment invoices created and tracked
Error Handling
| Error | Cause | Solution |
|---|---|---|
422 Invalid amount | Amount not in cents | Convert dollars to cents (multiply by 100) |
403 Payments not enabled | Feature not active | Enable Payments in Podium account |
| Review invitation failed | Customer opted out | Check contact preferences |
Resources
Next Steps
Handle webhook events: podium-webhooks-events