My Business Place Actions API

Name: My Business Place Actions API API
Brand: My Business Place Actions API
Availability: InStock

✓ Official Vendor SpecMarketingContent Managementoauth26 EndpointsREST

For Agents

Add and manage action links (book, order, reserve, appointments) on Google Business Profile listings. Use to drive direct conversions from Search and Maps panels.

Quickstart

Get started with My Business Place Actions API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"add a booking link to a Google Business listing"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with My Business Place Actions API API.

Create a place action link such as a booking or ordering URL on a location

List all action links currently configured on a location

Update an action link's URL or preferred status

Delete an obsolete or migrated action link

GET STARTED

Start building with My Business Place Actions API API

Explore with Jentic

View OpenAPI Document

Use for: Add a Reserve with Google booking link to a restaurant location, List all action links on a Business Profile location, Update the order ahead URL for a coffee shop location, Delete a deprecated appointments link

Not supported: Does not process bookings, take payments, or edit non-action listing fields — use for managing Google Business action link URLs only.

The My Business Place Actions API manages action links — book, order, reserve, menu, appointments — that appear on Google Business Profile listings in Google Search and Maps. It exposes placeActionLinks per location and a placeActionTypeMetadata listing that explains which action types each country and category supports. Use it to drive bookings and orders directly from a Business Profile panel without sending users to a search results page.

Use Cases

Patterns agents use My Business Place Actions API API for, with concrete tasks.

★ Booking Provider Migration

When a brand switches third-party booking providers, every Business Profile location's reserve link must change in lock-step. The placeActionLinks resource supports list, patch, and delete so a workflow can find the old provider's link, replace its URL with the new provider, and mark it preferred — keeping inbound conversion working through the migration window.

List /v1/{parent}/placeActionLinks with placeActionType=RESERVATION, PATCH the URL to the new provider, set isPreferred=true, then DELETE the old link.

Multi-Location Order-Ahead Roll-Out

Quick-service brands launching online ordering need an order link on every storefront's Business Profile. The Place Actions API accepts a per-location create with placeActionType=ONLINE_APPOINTMENT or FOOD_ORDERING, so a fan-out across the location list adds the new conversion point in minutes rather than per-location UI clicks.

Iterate over locations under accounts/{account} and POST /v1/{parent}/placeActionLinks with placeActionType=FOOD_ORDERING_DELIVERY and the order URL.

Region-Aware Action Coverage

Place action types are not uniformly supported across countries and categories. The placeActionTypeMetadata endpoint returns which types are valid given a regionCode and category, letting a workflow filter out unsupported actions before attempting to create them and avoiding 400 errors on PATCH.

GET /v1/placeActionTypeMetadata with regionCode and languageCode, build the supported set, and only create links whose placeActionType is in that set.

AI Agent Conversion Optimiser

An AI agent reachable through Jentic compares conversion data per location, tests new action link URLs, and rotates the preferred booking partner. Jentic isolates OAuth credentials and exposes the right Place Actions operation per intent so the agent never reads the discovery document or holds Google client secrets.

Search Jentic for 'add a booking link to a Google Business listing', load placeActionLinks.create, and execute with placeActionType=RESERVATION and the test URL.

Key Endpoints

6 endpoints — the my business place actions api manages action links — book, order, reserve, menu, appointments — that appear on google business profile listings in google search and maps.

METHOD

PATH

DESCRIPTION

GET

/v1/placeActionTypeMetadata

List supported action types and required fields

GET

/v1/{parent}/placeActionLinks

List action links on a location

POST

/v1/{parent}/placeActionLinks

Create an action link on a location

PATCH

/v1/{name}

Update an action link

DELETE

/v1/{name}

Delete an action link

GET

/v1/placeActionTypeMetadata

List supported action types and required fields

GET

/v1/{parent}/placeActionLinks

List action links on a location

POST

/v1/{parent}/placeActionLinks

Create an action link on a location

PATCH

/v1/{name}

Update an action link

DELETE

/v1/{name}

Delete an action link

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

OAuth 2.0 refresh tokens are stored encrypted in the Jentic vault. The agent receives scoped, short-lived access tokens — Google client secrets never enter the agent context.

Intent-based discovery

Agents search Jentic by intent (e.g. 'add a booking link to a Google Business listing') and Jentic returns the matching Place Actions operation with its input schema.

Time to first call

Direct integration: 1-2 days for OAuth, quota approval, and per-region action filtering. Through Jentic: under an hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

My Business Business Information API

Edits the parent location whose action links this API manages

Use Business Information to set the location's category, then use Place Actions to add category-appropriate links.

Alternative

Google My Business API (v4)

Older monolithic API with overlapping but coarser action link support

Pick Place Actions v1 for new builds; v4 lacks the placeActionTypeMetadata catalogue.

Complementary

My Business Verifications API

Verifies new locations before action links can appear publicly

Verify a new location first; action links only render on verified listings.

Complementary

Google Places API

Reads action links and place details for end-user discovery

Use Places to confirm a competitor's listing exposes a booking link; use Place Actions to manage your own.

FAQs

Specific to using My Business Place Actions API API through Jentic.

What authentication does the My Business Place Actions API use?

OAuth 2.0 with the https://www.googleapis.com/auth/business.manage scope. The user must be an admin on the target Business Profile account. Through Jentic the OAuth refresh token is held in MAXsystem and the agent only receives scoped short-lived access tokens.

Can I add a Reserve with Google link via this API?

Yes. POST /v1/{parent}/placeActionLinks with placeActionType=RESERVATION and the URL of your booking provider's deep link. Mark isPreferred=true if it should be the default reservation link on the listing.

What are the rate limits for the My Business Place Actions API?

Default quota is 0 QPM until Business Profile API access is granted. Once approved Google sets per-minute and per-day quotas; bulk action link sweeps should be paced and back off on 429 responses.

How do I update an action link through Jentic?

Search Jentic for 'update Google Business action link', load placeActionLinks.patch, and execute it with the new URL and updateMask=uri. Jentic handles the OAuth refresh in the background.

Why does creating an action link return INVALID_ARGUMENT for some categories?

Place action types are restricted by region and category. Call GET /v1/placeActionTypeMetadata with the location's regionCode and languageCode to see which types are valid for the location before creating the link.