What we do
Tools
Industries
Department
How we workLet's talk →
Home/Podium
Podium

The Podium API: Review Invites, Leads and Pay Links That Follow the Job

The crew wraps up a gutter job, the field service tool marks it done, and the review request sits until somebody opens Podium on a phone. That gap is what the Podium API is for. It's a REST API with OAuth 2.0 and scoped access to contacts, messages, reviews and payments, plus webhooks for new activity. You apply for a developer account first, and Podium takes a few days to review it.

Where Podium stops

A reply in Podium doesn't update the right customer record, and a finished job doesn't trigger a review request.

Stuck on Podium? Let's solve it →

Jobs you can hand to the Podium API, and the scope each one asks for

Podium asks you to pick the fewest scopes an app needs when you set up OAuth in the developer portal.

What should happen Scope Worth knowing
A review invite goes out when a job closes write_reviews, plus read_reviews to follow up The invite call takes the customer's phone or email and the location. Each link is single-use, and the invite record shows whether it was sent, delivered and clicked.
Your CRM and Podium hold the same customer write_contacts and read_contacts Contacts can be created, updated and deleted. Decide in your own code how a returning customer gets matched, so one person doesn't become two contacts.
Webchat and text conversations reach the CRM read_messages, plus a webhook New messages arrive as webhook events, so the lead record can open while the conversation is still going.
A pay link carries the real invoice amount write_payments Invoices can be created, cancelled and refunded through the API. A cancelled invoice can't take a payment anymore.
Payments reach your accounting tool read_payments Payment data is readable, which is what a sync to the books starts from.
A booked job shows up in Podium write_appointments Podium's scope list has a write scope for appointments and no read scope, so keep your scheduling tool as the record that wins.

A roofing and gutter company that stopped batching review requests

Roofing and gutter company · jobs tracked in a field service tool · Podium for texting and reviews

Before

Review requests went out when someone remembered, often as a batch at the end of the month, long after the customer had stopped thinking about the job.

After

Marking a job complete in the field service tool fires the Podium review request, timed for when the customer's likely to answer.

Reviews now come in steadily through the month instead of in one late wave.

Podium webhook and OAuth traps that cost you events

A webhook left disabled for too long

How you'll know: You paused the webhook during a move to a new server, turned it back on two weeks later, and the oldest conversations never arrived.

Fix: Podium queues events from the moment a webhook is created, even while it's disabled, but they expire after about 10 days. Keep any pause shorter than that, and backfill from the API if you miss the window.

An endpoint that thinks before it answers

How you'll know: Your handler writes to the CRM and then replies, and deliveries keep timing out.

Fix: Podium waits 5 seconds for a response. Acknowledge right away, verify the signature, and do the CRM work from a queue.

Only one location subscribed

How you'll know: Messages from the main shop reach the CRM, and the second location is silent.

Fix: Each webhook belongs to exactly one location or organization. Subscribe at the organization, or create one per location, with a token from a user who can see it.

The client secret is gone

How you'll know: Nobody copied the secret when the app was saved, and the integration can't get new tokens.

Fix: Podium only shows the secret once. Regenerate it and store it straight away, and remember that a new secret doesn't revoke tokens already issued.

One review link sent twice

How you'll know: A retry or a second job on the same day reuses yesterday's invite link.

Fix: Podium's docs say not to reuse invite links. Create a fresh invite per job and record its ID against the job.

Five things to settle before anyone writes Podium code

  • Is your job tool already in Podium's marketplace?

    Podium lists ready-made partner integrations for a number of field service and business tools. If one already sends invites on the trigger you want, you may not need a build at all.

  • What counts as the job being done?

    Completed, invoiced or paid can be days apart. The review request should go on the status your crews actually set reliably.

  • Which location sends the invite?

    Invites and webhooks are tied to a location, so a multi-location business has to map each crew or branch to the right one.

  • Which system owns the customer record?

    When Podium and the CRM disagree on a phone number or name, one of them has to win, and the sync needs to know which.

  • Where should a Podium payment land in the books?

    Payment data is readable through the API, but someone still has to decide which account and which invoice in your accounting tool it settles.

Let's talk

Podium on one side, the job board on the other, and a person carrying things between them?

n-frames builds the Podium API connection to your field service tool, CRM and books: invites fired by job status, webchat leads opened as contacts, and pay links tied to the real invoice.

Podium tied to the job board →

Podium basics, from login to payments

What is Podium?

A messaging and reputation platform for local and multi-location businesses. Website chat that turns into a text thread, review requests and review monitoring, and payment by text link all sit in one inbox.

Does Podium have an API, and who can get access?

Yes. You apply for a developer account at developer.podium.com, Podium reviews it over a few days, and then you create an app with a redirect URL and scopes. A user of the Podium account you're connecting has to authorize the app through OAuth.

How much does Podium cost?

Podium sells subscriptions in tiers, depending on features such as reviews, webchat and payments. It changes its plans, so get current numbers from Podium. The API work runs on top of whichever plan you're on.

Can Podium collect payments by text?

Yes. Podium Payments sends a secure link by text, and the customer pays from their phone without a card reader. Through the API, an invoice can be created with its real line items, so the amount isn't retyped from your accounting tool.

Does Podium help with getting more Google reviews?

That's one of its main jobs. It texts review requests that send customers to your Google Business Profile or other review sites, and lets you watch and reply from one dashboard. What it can't know on its own is when your job finished, which is where the API comes in.

Where do I log into Podium?

At podium.com, or in the Podium mobile app, with your business account email. If you aren't sure which email the account is under, ask whoever first set Podium up for the business.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.