Podium Reference Architecture

---
name: podium-reference-architecture
description: "Podium reference architecture \u2014 business messaging and communication\
  \ platform integration.\nUse when working with Podium API for messaging, reviews,\
  \ or payments.\nTrigger with phrases like \"podium reference architecture\", \"\
  podium-reference-architecture\".\n"
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep
version: 2.0.0
license: MIT
tags:
- saas
- podium
- messaging
- reviews
- payments
compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
---
# Podium Reference Architecture

## Overview
Implementation patterns for Podium reference architecture using the REST API with OAuth2 authentication.

## Prerequisites
- Completed `podium-install-auth` setup
- Valid OAuth2 access token

## Instructions

### Step 1: API Call Pattern
```typescript
import axios from 'axios';

const podium = axios.create({
  baseURL: 'https://api.podium.com/v4',
  headers: { 'Authorization': `Bearer ${process.env.PODIUM_ACCESS_TOKEN}` },
});

const { data } = await podium.get('/locations');
console.log(`Locations: ${data.data.length}`);
```

## Output
- Podium API integration for reference architecture
- OAuth2 authenticated requests
- Error handling and retry logic

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| 401 Unauthorized | Expired token | Refresh OAuth token |
| 429 Rate Limited | Too many requests | Implement backoff |
| 403 Forbidden | Missing scope | Update OAuth app scopes |

## Resources
- [Podium Developer Portal](https://developer.podium.com/)
- [Podium API Docs](https://docs.podium.com)

## Next Steps
See related Podium skills for more workflows.