Advanced API & Webhook Configuration

For organizations looking to integrate geographic intelligence into their broader DevOps or data engineering pipelines, GeoMap provides a robust set of API endpoints and webhook triggers. This allows for the "Headless" management of your map visualizations, ensuring they stay perfectly in sync with complex, multi-step data workflows in Smartsheet and beyond.

Triggering Programmatic Refreshes

While GeoMap polls Smartsheet every 5 minutes, certain high-velocity workflows require an immediate update upon a specific event (e.g., a "New Order" appearing in your CRM).
- **The Refresh Endpoint:** You can trigger an immediate re-scan of any GeoMap configuration by sending a POST request to our specialized refresh URL. This bypasses the polling interval and ensures your map dashboard reflects the absolute latest data.
- **Payload Structure:** Authentication is handled via an API Key provided in your account dashboard. The request requires the `mapId` and a `securityToken` to ensure authorized access.

Customizing Webhook Payloads

GeoMap webhooks are "Schema-Aware." Within the administration docs, you can define exactly which Smartsheet columns are included in the webhook POST body.
1. **Filtering at the Source:** Configure your webhook to only fire if certain criteria are met (e.g., only if the "Status" column changes to "Delayed").
2. **Data Transformation:** Choose between "Full Object" payloads (including every mapped column) or "Delta Only" payloads (including only the changed fields). This reduces the processing load on your receiving server.

SME Strategy: Building a Geographic Control Plane

We recommend using our API to build a "Geographic Control Plane." For example, if your company manages 500 different project maps, you can use a script to programmatically update the "Pin Colors" for all 500 maps at once via the API. This centralized management ensures brand consistency and operational uniformity across the entire enterprise, eliminating the need for manual configuration as your organization scales. By treating your map configurations as "Code," you bring a new level of rigor and scalability to your spatial intelligence operations.