2026-02-03

Location sharing started

Triggered when a contact starts sharing their location with you.

began_at and ends_at are always present. ends_at is null when the contact shares indefinitely, so the key never disappears from the payload.

chat_id is the chat the share was first sent to. Sharing is per-contact, not per-chat, so the location can also be visible in other chats with the same handle — sharing into another chat later does not move chat_id and does not send another event.

postWebhooklocation.sharing.started.v2026-02-03

Payload

api_versionstring required

API version for the webhook payload format

webhook_versionstring required

Date-based webhook payload version. Determined by the ?version= query parameter in your webhook subscription URL. If no version parameter is specified, defaults based on subscription creation date.

event_type'location.sharing.started' required

Valid webhook event types that can be subscribed to.

Note: message.edited is only delivered to subscriptions using webhook_version: "2026-02-03". Subscribing to this event on a v2025 subscription will not produce any deliveries.

event_idstring uuid required

Unique identifier for this event (for deduplication)

created_atstring date-time required

When the event was created

trace_idstring required

Trace ID for debugging and correlation across systems.

partner_idstring required

Partner identifier. Present on all webhooks for cross-referencing.

Example payload

{
  "api_version": "v3",
  "webhook_version": "2025-01-01",
  "event_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2025-11-23T17:30:00Z",
  "trace_id": "abc123def456",
  "partner_id": "partner_abc123",
  "data": {
    "shared_by": "+15551234567",
    "shared_with": "+15559876543",
    "began_at": "2026-02-04T12:00:00Z",
    "ends_at": "2026-02-04T13:00:00Z",
    "chat_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Response

Webhook received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.