Supported technology/Radios
| Direction | Two-way |
| Platform | Gundi v2 |
| Type | Push integration |
| Data | Location, Messages |
Garmin inReach devices send their positions and messages to EarthRanger through Gundi. Positions show up as tracks on the map.
This integration requires configurations in the Garmin Portal, Gundi, and EarthRanger. Please contact us at support@earthranger.com and we’ll guide you through the process to ensure everything is set up correctly.
We are actively working to make this integration self-service in the future. Stay tuned for updates!
What you'll receive
We add details here as we confirm what Garmin inReach sends. If you know something we're missing, let us know.
| Positions | Yes |
| Alerts and events | Not documented yet |
| Sensor readings | Not documented yet |
| Photos and files | No |
| Messages | Yes |
| Past data | Not documented yet |
How this integration works
This is a push integration. The data provider sends data to Gundi whenever it has something new, on its own schedule. Gundi passes each piece on to your destination as soon as it arrives.
Who's involved
- You create the Route in Gundi and share its API key with the data provider.
- The data provider turns on sending to Gundi with that key.
- Your destination, for example EarthRanger, is where the data shows up.
- Gundi support helps only when the setup badge at the top of this page says so.
Historical data
Gundi passes on whatever the provider sends, old or new. Gundi can't ask the provider for past data, so if you need history, ask the provider whether they can send it again.
When data doesn't show up
Gundi doesn't check the provider for new data; it waits for the provider to send it. If nothing arrives, check with the provider first that they are sending, then look at your Route Activity Logs.
How often data arrives
That depends on how often the provider sends it. Some send each reading right away, others in batches every few minutes or hours.
Prerequisites
Garmin InReach
You will need:
- Garmin Explore (Garmin Explore™) account.
- Garmin Professional Subscription.
Gundi
You will need:
- A Gundi account.
EarthRanger
You will need:
- Admin access to EarthRanger.
- A special EarthRanger user with permissions to post observation data and messages.
- A long-lived token for the special user.
Please refer to EarthRanger's documentation or contact Support.
Configurations
A single Route in Gundi carries both directions of this integration:
- InReach to EarthRanger — locations and messages from the radios reach EarthRanger.
- EarthRanger to InReach — messages written in EarthRanger are delivered to the radios. This is the arrow that goes back from EarthRanger to InReach on the Route's flow map.
1. Create the Route in Gundi
1.1 Log in to Gundi and click
Create Route.
1.2 Select Garmin InReach.
1.3 Select
your Workspace and enter a Route Name (e.g., InReach to ER). Leave all other fields empty and
click Next.
1.4 Click Add destination on the flow map and
select your EarthRanger site. Please consult
our guide.
1.5 On the flow map, click the
InReach node and open the Connect API key section. Copy the
API Key; you will use it in the next step.
2. Garmin (Outbound Settings) — radios to EarthRanger
2.1 Log in to https://explore.garmin.com/
2.2 Go
to Settings Portal Connect.
2.3 Turn
Outbound Settings ON.
2.4 Set the Outbound Settings URL:
https://hooks.gundiservice.org/webhooks?integration_type=inreach&apikey=[apikey]
Important: replace [apikey] with the API Key you
copied from the InReach node's Connect section.
2.5 Click Test.
2.6 Click Save.
You should see a subject with an observation and a message on the EarthRanger site.
3. Garmin (Inbound Settings) — EarthRanger to radios
3.1 In https://explore.garmin.com/, go to
Settings Portal Connect.
3.2 Turn
Inbound Settings ON.
3.3 Configure an
IPC User Name and
IPC Password. These fields can't be left blank.
3.4 Take
note of the Inbound URL (Garmin). Example:
4. Enter the Garmin inbound credentials in Gundi
4.1 Back on the Route's flow map, click the InReach node and open
Connection Credentials.
4.2 Fill in the fields so they match the IPC
Inbound settings from step 3:
inReach Portal Connect (IPC) Inbound API:
Inbound URL (Garmin)Username:
IPC User NamePassword:
IPC Password
https://Example:
Replace “eur-enterprise.inreach.garmin.com”
with “https://eur-enterprise.inreach.garmin.com”
4.3 Click Save, then Test Connection.
5. Turn on the flow back to InReach
5.1 On the flow map, click the arrow that goes from your EarthRanger site back to the InReach
node (or its Configure Flow button).
5.2 In the panel that opens (Your Site InReach), turn Sending ON. The arrow becomes solid.
6. Copy the EarthRanger API Key
6.1 On the flow map, click your EarthRanger node and open the
Connect API key section.
6.2 Copy the
API Key; you will use it in the next step.
7. Configure EarthRanger
7.1 Log in to the admin site.
7.2 Go to Source Providers.
7.3 Search
for the source provider created for this integration (i.e.,
gundi_inreach_integrationid).
7.4 Enable Two-way messaging:
- Choose adapter type “smart-integrate-adapter”
- Enter URL: https://sensors.api.gundiservice.org/v2/messages/
- Enter the API Key copied from the EarthRanger node in step 6
7.5 Click Save.
Troubleshooting
Contact the Gundi team to confirm that the integration requirements (e.g., Garmin Professional Subscription) are met. Also, provide the list of device IMEIs.
Learn more
Developer Documentation
Garmin InReach Connect Portal Developer Guide
Other Radios
| Everywhere Communications | RockSeven | Kenwood |
| Hytera | TRBOnet Enterprise |
| Back to the integration catalog | Need help setting this up? Contact us |
