What is new in the latest version (v4) of the Locations API?

• Automatic updates of location updates.
• Improved validation for all data sent through the API.
• You can now get and set Google attributes.
• Create and manage hybrid- and service area locations – just like storefront locations.

Are you a developer?

For technical documentation read our Locations API documentation

Contents

• What You Can Build with the Locations API
• Setting up API access
• Automatic Updates
• FAQ

What You Can Build with the Locations API

One Source of Truth

Sync your internal systems with PinMeTo so location data (addresses, opening hours, attributes, etc.) stays consistent everywhere. You decide if your source of truth should be PinMeTo or your own systems or databases.

Empower Local Teams

Build tools that let store managers or local/regional teams update details such as opening hours, attributes or temporary closures (e.g. renovations). Updates can be automatically published or manually reviewed in PinMeTo.

Setting up API access

For instructions, please refer to the main API article.

Automatic Updates

When integrating with the Locations API v4, you can choose how updates are handled:

• Routine updates (like open hours or attributes) can be set to publish automatically.
• Address or coordinate changes will show up in your To Do-list in the dashboard.
• New locations must always be verified before going live.

How Locations API v4 Handles Updates

In earlier versions of the API, updates from your systems were saved in PinMeTo but not automatically published to connected networks.

This registered as data conflicts between the updated information in PinMeTo and the information on networks, requiring you to manually resolve them before updates could go live.

With Locations API v4, you can automate this step. Updates sent from your internal systems are now updating the PinMeTo data and sent to your connected networks automatically — keeping all data in sync and reducing manual work.

To Enable Automatic Updates

1. Make sure you are using the newest version of the Locations API (v4).
2. Go to Account Settings → API.
3. Under API Settings, check the box for Locations API v4.
4. Click Save to apply the changes.

FAQ

Do I need to know how to code to use the Locations API?

No. As a PinMeTo user you don’t need coding skills. But you do need an API Developer or your IT department to connect your systems to the API.

Who in my team should set this up?

Typically, your API Developer or IT team will handle the technical setup. If you are a user in PinMeTo with the role Owner, start by adding a new user in Account Settings. Add the person who will handle the technical implementation and set their role to "API Developer". Read more about setting up the API.

Does Automatic Updates mean I won't have to resolve conflicts?

No. When you send an update through the API, the new information is published to connected networks — and this will often resolve existing conflicts for that field.

However, if the data hasn’t changed, no update is sent. In those cases, any existing conflicts will remain until they’re manually resolved in PinMeTo.

Do I still need to review address changes or verify new locations?

Yes. Address or coordinate changes sent through the API appear in your To Do list for manual review before publishing. New locations created via the API must also be verified in PinMeTo before going live.

You can find both tasks in the To Do section of your Listings dashboard.

Can local teams use this without giving them full access to PinMeTo?

Yes. You can build custom tools with the API that let local teams manage specific details. What functionality the local teams should have access to is handled inside your own systems. Their updates are sent into PinMeTo for approval or automatic publishing, while you keep centralized oversight.

Updated on: 13/10/2025