name: podium-hello-world description: "Podium hello world \u2014 business messaging and communication platform
\ integration.\nUse when working with Podium API for messaging, reviews, or payments.\n
Trigger with phrases like "podium hello world", "podium-hello-world".\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 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

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

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

// 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

Resources

• Podium API Reference
• Sync Messages

Next Steps

Build messaging workflow: podium-core-workflow-a