---
title: "Subscribe to geofencing notifications for a VIN and geofence collection."
method: POST
path: "/v1/geofencing-notifications/subscribe"
tags: ["Geofencing Notifications"]
---

# Subscribe to geofencing notifications for a VIN and geofence collection.

`POST /v1/geofencing-notifications/subscribe`

## Request

- Base URL: `https://api.stellantis-developers.com`
- URL: `https://api.stellantis-developers.com/v1/geofencing-notifications/subscribe`
- Auth: API key in header `x-api-key` and API key in header `Authorization`
- TypeScript: <https://skmtc.dev/stellantis/apis/stellantis-connected-vehicle-api/docs/v1/geofencing-notifications/subscribe/post.ts> (a function with typed inputs; its response is checked against the schema)

Subscribe endpoints such as phone numbers, email addresses, and head unit VINs to geofencing notifications. Subscribed head unit VINs will receive in-vehicle popups with geofence breach information.

## Request body

- SubscribeToGeofencingNotifcationsRequest
  - `vin` string, required
  - `collection_name` string, required
  - `HU_vin_for_popup` string
  - `phone_numbers` string[]
  - `emails` string[]

## Response `200`

- string

## Other responses

- `400`: bad input parameter
- `403`: not authorized
- `500`: internal server error

---

[API](https://skmtc.dev/stellantis/apis/stellantis-connected-vehicle-api.md) - [All operations](https://skmtc.dev/stellantis/apis/stellantis-connected-vehicle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stellantis/apis/stellantis-connected-vehicle-api/revisions/1d2213b04fdb?raw)