Agent skill

podium-hello-world

Podium hello world — business messaging and communication platform integration. Use when working with Podium API for messaging, reviews, or payments. Trigger with phrases like "podium hello world", "podium-hello-world".

Stars 1,803
Forks 241

Install this agent skill to your Project

npx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/main/plugins/saas-packs/podium-pack/skills/podium-hello-world

SKILL.md

Podium Hello World

Overview

Send your first Podium message, list contacts, and check location details using the Podium REST API.

Prerequisites

  • Completed podium-install-auth setup with valid access token
  • A Podium location ID

Instructions

Step 1: List Locations

typescript
const { data } = await podium.get('/locations');
for (const loc of data.data) {
  console.log(`Location: ${loc.attributes.name} (ID: ${loc.id})`);
}

Step 2: List Contacts

typescript
const locationId = 'loc_xxxxx';
const { data } = await podium.get(`/locations/${locationId}/contacts`);
for (const contact of data.data) {
  console.log(`  ${contact.attributes.name} — ${contact.attributes.phone}`);
}

Step 3: Send a Message

typescript
// Messages are sent via the Podium platform to the customer's phone
const { data } = await podium.post(`/locations/${locationId}/messages`, {
  data: {
    attributes: {
      body: 'Hello from our integration! How can we help?',
      'contact-phone': '+15551234567',
    },
  },
});
console.log(`Message sent: ${data.data.id}`);

Output

  • Listed locations with IDs
  • Retrieved contacts for a location
  • Sent a test message via Podium

Error Handling

Error Cause Solution
404 Location not found Wrong location ID List locations first to get valid IDs
422 Invalid phone Bad phone format Use E.164 format: +15551234567
403 Forbidden Missing scope Add messages.write scope to OAuth app

Resources

Next Steps

Build messaging workflow: podium-core-workflow-a

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results