Podium Core Workflow B Skill

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

Agent Skills: Podium Core Workflow B

Install this agent skill to your local

Skill Files