# Podium

> Podium is a customer communication and lead-conversion platform for local businesses. Its v4 REST
> API covers text and webchat messaging, conversations, contacts, reviews and review responses,
> payments and invoicing, campaigns, appointments, phones/calls, products, feedback surveys and
> webhooks. All requests go to https://api.podium.com/v4/ over HTTPS with an OAuth 2.0 bearer
> token, are limited to about 300 requests per minute, and should carry a dated `podium-version`
> header.

This file was generated by API Evangelist from Podium's published surface; Podium does not serve
an llms.txt of its own (https://docs.podium.com/llms.txt returns 404).

## APIs

- [Podium API reference](https://docs.podium.com/reference/introduction): 86 operations across 12
  OpenAPI definitions, base URL https://api.podium.com/v4/
- [Authentication](https://docs.podium.com/reference/authentication): OAuth 2.0 bearer tokens
- [OAuth guide](https://docs.podium.com/docs/oauth): authorization code + refresh token; authorize
  https://api.podium.com/oauth/authorize, token https://api.podium.com/oauth/token; access tokens
  last 10 hours
- [OAuth scopes](https://docs.podium.com/docs/oauth-scopes): 17 published scopes; 25 in total once
  the scopes named inside the specs are included
- [Pagination](https://docs.podium.com/reference/pagination): cursor based, `limit` 1-100 (default
  10), `metadata.nextCursor`
- [Errors](https://docs.podium.com/docs/errors): custom `{code, message, moreInfo}` envelope
- [Versioning](https://docs.podium.com/docs/api-version): dated `podium-version` header
- [Webhooks](https://docs.podium.com/docs/webhooks): 26 event types, HMAC-SHA256 signed

## Specs

- [Accounts](openapi/podium-accounts-openapi.yml): locations, organizations, users (6 operations)
- [Appointments](openapi/podium-appointments-openapi.yml): create appointments (1)
- [Campaigns](openapi/podium-campaigns-openapi.yml): campaigns and campaign interactions (7)
- [Contacts](openapi/podium-contacts-openapi.yml): contacts, attributes, tags, opt in/out (21)
- [Conversations](openapi/podium-conversations-openapi.yml): conversations, assignees, notes, lead
  writeback (7)
- [Feedback (Surveys)](openapi/podium-feedback-surveys-openapi.yml): feedback surveys (2)
- [Messenger](openapi/podium-messenger-openapi.yml): send/import messages, message templates (9)
- [Payments](openapi/podium-payments-openapi.yml): invoices, charges, refunds, readers (11)
- [Phones](openapi/podium-phones-openapi.yml): calls (1)
- [Products](openapi/podium-products-openapi.yml): products and product images (4)
- [Reviews](openapi/podium-reviews-openapi.yml): reviews, invites, responses, attributions,
  summaries (12)
- [Webhooks](openapi/podium-webhooks-openapi.yml): webhook management + the event type enum (5)

## Artifacts

- [Authentication profile](authentication/podium-authentication.yml)
- [OAuth scopes](scopes/podium-scopes.yml)
- [API conventions](conventions/podium-conventions.yml)
- [Error catalog](errors/podium-problem-types.yml)
- [Webhook event catalog](asyncapi/podium-webhooks.yml)
- [Lifecycle and versioning](lifecycle/podium-lifecycle.yml)
- [Changelog](changelog/podium-changelog.yml)
- [Sandbox / test accounts](sandbox/podium-sandbox.yml)
- [Data model](data-model/podium-data-model.yml)
- [Packages / SDKs](packages/podium-packages.yml)
- [Conformance](conformance/podium-conformance.yml)
- [Agent skills](skills/_index.yml)
- [Rate limits](rate-limits/podium-rate-limits.yml)
- [Plans and pricing](plans/podium-plans-pricing.yml)

## Docs

- [Getting started](https://docs.podium.com/docs/getting-started)
- [Developer portal](https://developer.podium.com/)
- [Test accounts](https://docs.podium.com/docs/podium-test-accounts)
- [Verifying webhook signatures](https://docs.podium.com/docs/verifying-webhook-signatures)
- [Webhook retries](https://docs.podium.com/docs/webhook-retries)
- [Changelog](https://docs.podium.com/changelog)
- [Postman workspace](https://www.postman.com/podiumhq/podium-s-api-workspace)
- [Status page](https://status.podium.com)
- [Trust center](https://trust.podium.com)
- [Legal center](https://legal.podium.com/)

## Notes

- Podium ships no MCP server, no A2A agent card, no llms.txt, no AsyncAPI and no /.well-known
  document of any kind.
- The only first-party client library is podium_ex (Elixir, hex.pm), last released 2020-02-13 and
  now archived.
- Idempotency exists on exactly one operation: `invoice.charge` accepts an optional
  `idempotencyUid`.