> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Radar

The Radar connector lets your AI agent act in each user's Radar account. Each user connects their own Radar API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 39 tools.

**Authentication:** API Key
**Categories:** Developer Tools, Analytics
**Tools:** 39: 23 read, 12 write, 4 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=RADAR)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Radar connection

   In **AgentKit > Connections**, create a Radar connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'radar'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Radar:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'radar_beacons_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "radar"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Radar:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="radar_beacons_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Radar credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'radar_address_validate',
  toolInput: {
    city: '<city>',
    country_code: '<country_code>',
    postal_code: '<postal_code>',
    state_code: '<state_code>',
  },
  connector: 'radar',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="radar_address_validate",
    tool_input={
        "city": "<city>",
        "country_code": "<country_code>",
        "postal_code": "<postal_code>",
        "state_code": "<state_code>",
    },
    connection_name="radar",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `radar_address_validate`

Validate Address · Read-only

Validate and normalize a postal address.
Returns the verified address with its components and a verification status.
Use Forward Geocode to get coordinates for an address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `city` (`string`, required): The city name. Example: Brooklyn.
- `country_code` (`string`, required): The unique 2-letter country code (e.g., US). Example: US.
- `postal_code` (`string`, required): The postal or zip code. Plus 4 codes are accepted but not required. Example: 11201.
- `state_code` (`string`, required): The 2-letter state abbreviation (e.g., NY). Example: NY.
- `address_label` (`string`, optional): The first line of the address, including the building number, street name, and unit number if applicable (e.g., 20 Jay St Apt 3). Required if number and street aren't provided. Example: 20 Jay St.
- `number` (`string`, optional): The building or P.O. box number. Required with street if addressLabel isn't provided. Example: 20.
- `street` (`string`, optional): The street name. Required with number if addressLabel isn't provided. Example: Jay St.
- `unit` (`string`, optional): The unit number, such as apartment or suite (e.g., Apt 3). Example: Apt 3.

Example input: `{"city":"<city>","country_code":"<country_code>","postal_code":"<postal_code>","state_code":"<state_code>"}`

### `radar_autocomplete`

Autocomplete · Read-only

Autocomplete a partial address or place name, preferring results near a location.
Returns suggested addresses and places with coordinates and, with a session token, result IDs.
Use Autocomplete Select to record the chosen result. Use Forward Geocode for complete addresses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The partial address or place name to autocomplete. Example: 20 Jay St Brooklyn.
- `country_code` (`string`, optional): An optional countries filter. A string of comma-separated countries, the unique 2-letter country code. Example: US.
- `layers` (`string`, optional): Optional layer filters. A string, comma-separated, including one or more of place, address, postalCode, locality, county, state, country, coarse, and fine. Note that coarse includes all of postalCode, locality, county, state, and country, whereas fine includes address and place. If not provided, results from address and coarse layers will be returned. Example: address.
- `limit` (`number`, optional): The max number of addresses to return. A number between 1 and 100. Defaults to 10. Example: 10.
- `near` (`string`, optional): The location to prefer search results near. A string in the format latitude,longitude. If not provided, the request IP geolocation will be used to anchor the search. Example: 40.7041,-73.9867.
- `session_token` (`string`, optional): A UUID grouping the requests from one address field. When provided, each result carries a resultId that can be reported to the autocomplete select endpoint. Example: 6f1c2a3b-4d5e-4f60-8a9b-0c1d2e3f4a5b.

Example input: `{"query":"<query>"}`

### `radar_beacon_get`

Get Beacon · Read-only

Get one beacon by its Radar _id.
Returns its tag, external ID, type, identifiers, location and metadata.
Use List Beacons to find beacons.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `beacon_id` (`string`, required): The beacon's Radar _id. Example: 6109a4b16dbfe3de2cb03924.

Example input: `{"beacon_id":"<beacon_id>"}`

### `radar_beacons_list`

List Beacons · Read-only

List Bluetooth beacons, filterable by tag, external ID and dates.
Returns beacons with tag, external ID, type, identifiers, location and enabled flag.
Use Get Beacon for one beacon.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_after` (`string`, optional): A cursor for use in pagination. Retrieves beacons updated after the specified datetime. A date or valid ISO date string. Example: 2026-11-01T00:00:00Z.
- `created_before` (`string`, optional): A cursor for use in pagination. Retrieves beacons updated before the specified datetime. A date or valid ISO date string. Example: 2026-11-16T00:00:00Z.
- `external_id` (`string`, optional): Retrieves beacons with the specified externalId. Example: 123.
- `limit` (`number`, optional): The max number of beacons to return. A number between 1 and 1000. Defaults to 100. Example: 10.
- `tag` (`string`, optional): Retrieves beacons with the specified tag. Example: store.

Example input: `{}`

### `radar_fraud_action_get`

Get Fraud Action Status · Read-only

Get the status of a block or unblock action.
Returns the action's status and affected users and devices.
Use the action ID from Block or Unblock Users or Devices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `action_id` (`string`, required): Action ID from the statusUrl returned by Block or Unblock. Example: act_123.

Example input: `{"action_id":"<action_id>"}`

### `radar_geocode_forward`

Forward Geocode · Read-only

Convert a complete address into coordinates.
Returns matching addresses with latitude, longitude, formatted address, components, confidence and time zone.
Use Autocomplete for partial addresses or place names. Use Reverse Geocode for coordinates to address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): The address to geocode. Example: 20 Jay St Brooklyn.
- `country` (`string`, optional): An optional countries filter. A string of comma-separated countries, the unique 2-letter country code. Example: US.
- `lang` (`string`, optional): Specifies the language for the results. A string, one of ar, de, en, es, fr, ja, ko, pt, ru, zh. Defaults to en. Example: en. One of: `ar`, `de`, `en`, `es`, `fr`, `ja`, `ko`, `pt`, `ru`, `zh`.
- `layers` (`string`, optional): Optional layer filters. A string, comma-separated, including one or more of place, address, postalCode, locality, county, state, country, coarse, and fine. Note that coarse includes all of postalCode, locality, county, state, and country, whereas fine includes address and place. If not provided, results from address and coarse layers will be returned. Example: address.

Example input: `{"query":"<query>"}`

### `radar_geocode_reverse`

Reverse Geocode · Read-only

Convert coordinates into an address.
Returns addresses for the location with formatted address, components and time zone.
Use Forward Geocode for address to coordinates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `coordinates` (`string`, required): The coordinates to reverse geocode. A string in the format latitude,longitude. Example: [40.7041, -73.9867].
- `layers` (`string`, optional): Optional layer filters. A string, comma-separated, including one or more of place, address, postalCode, locality, county, state, country, coarse, and fine. Note that coarse includes all of postalCode, locality, county, state, and country, whereas fine includes address and place. If not provided, results from address and coarse layers will be returned. Example: address.

Example input: `{"coordinates":"<coordinates>"}`

### `radar_geofence_get`

Get Geofence · Read-only

Get one geofence by its Radar _id.
Returns its tag, external ID, description, type, geometry, metadata and settings.
Use Get Geofence by External ID when you know the tag and external ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `geofence_id` (`string`, required): The geofence's Radar _id. Example: 56db1f4613012711002229f5.

Example input: `{"geofence_id":"<geofence_id>"}`

### `radar_geofence_get_by_external_id`

Get Geofence by External ID · Read-only

Get one geofence by its tag and external ID.
Returns its description, type, geometry, metadata and settings.
Use Get Geofence when you have the Radar _id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `external_id` (`string`, required): The geofence external ID within the tag. Example: 123.
- `tag` (`string`, required): The geofence tag (its group). Example: store.

Example input: `{"external_id":"<external_id>","tag":"<tag>"}`

### `radar_geofence_users_list`

List Users in Geofence · Read-only

List the users currently inside a geofence.
Returns the users with location and device details.
Use Get User for one user's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `external_id` (`string`, required): The geofence external ID within the tag. Example: 123.
- `tag` (`string`, required): The geofence tag (its group). Example: store.

Example input: `{"external_id":"<external_id>","tag":"<tag>"}`

### `radar_geofences_list`

List Geofences · Read-only

List geofences, most recently updated first, filterable by tag, external ID and dates.
Returns geofences with tag, external ID, description, type, geometry, metadata and enabled flag.
Use Search Geofences to find geofences near a location.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_after` (`string`, optional): Retrieves geofences created after the specified datetime. A date or valid ISO date string. Example: 2026-11-01T00:00:00Z.
- `created_before` (`string`, optional): Retrieves geofences created before the specified datetime. A date or valid ISO date string. Example: 2026-11-16T00:00:00Z.
- `external_id` (`string`, optional): Retrieves geofences with the specified externalId. Example: 123.
- `limit` (`number`, optional): The max number of geofences to return. A number between 1 and 1000. Defaults to 100. Example: 10.
- `tag` (`string`, optional): Retrieves geofences with the specified tag. Example: store.
- `updated_after` (`string`, optional): A cursor for use in pagination. Retrieves geofences updated after the specified datetime. A date or valid ISO date string. Example: 2026-11-01T00:00:00Z.
- `updated_before` (`string`, optional): A cursor for use in pagination. Retrieves geofences updated before the specified datetime. A date or valid ISO date string. Example: 2026-11-16T00:00:00Z.

Example input: `{}`

### `radar_geofences_search`

Search Geofences · Read-only

Find your geofences near a location, optionally by tag and radius.
Returns geofences with tag, external ID, description, metadata and geometry.
Use List Geofences to page through all geofences.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `near` (`string`, required): A location for the search. A string in the format latitude,longitude. Example: 40.7041,-73.9867.
- `include_geometry` (`boolean`, optional): Include geofence geometries in the response. Defaults to true. Example: false.
- `limit` (`number`, optional): The max number of geofences to return. A number between 1 and 1000. Defaults to 100. Example: 10.
- `radius` (`number`, optional): Optional radius to search, in meters. Example: 100.
- `tags` (`string`, optional): Optional tag filters. A string, comma-separated. Example: store,venue.

Example input: `{"near":"<near>"}`

### `radar_places_search`

Search Places · Read-only

Find places (stores, restaurants, airports and more) near a location by chain or category, or an airport by IATA code.
Returns places with name, chain, categories and location.
Use Autocomplete to search places by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `near` (`string`, required): A location for the search. A string in the format latitude,longitude. Example: 40.7041,-73.9867.
- `categories` (`string`, optional): Category filters. A string, comma-separated. If not provided, chains must be provided. Example: coffee-shop.
- `chains` (`string`, optional): Chain slug filters. A string, comma-separated. If your project has a chain mapping, the mapped ID can be used in place of the chain slug. If not provided, categories must be provided. Example: starbucks.
- `iata_code` (`string`, optional): The 3-letter IATA code for the airport to search. If provided, no other parameters are required. Example: JFK.
- `limit` (`number`, optional): The max number of places to return. A number between 1 and 100. Defaults to 10. Example: 10.
- `radius` (`number`, optional): The radius to search, in meters. A number between 1 and 10000. Defaults to 1000. Example: 100.

Example input: `{"near":"<near>"}`

### `radar_places_settings_get`

Get Places Settings · Read-only

Get the project's Places settings.
Returns chain metadata, chain mappings and place filters.
Use Update Places Settings to change them.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `radar_route_directions`

Directions · Read-only

Get turn-by-turn directions through up to 25 locations in order.
Returns routes with distance, duration, legs, steps and geometry.
Use Optimize Route to find the best visiting order. Use Route Distance for distance and time only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `locations` (`string`, required): A list of up to 25 coordinates to visit in order. A pipe-delimited string in the format latitude0,longitude0|latitude1,longitude1|.... Example: 40.7041,-73.9867|40.7484,-73.9857.
- `alternatives` (`boolean`, optional): Specifies whether to try to return alternative routes. This feature is available if only two locations are specified. Defaults to false. Example: false.
- `avoid` (`string`, optional): The features that calculated routes should avoid. A string, comma-separated, including one or more of tolls, highways, ferries and borderCrossings. No features are avoided if not provided. Example: tolls,highways.
- `departure_time` (`string`, optional): The date and time of the route provided as an ISO 8601 date string (e.g., 2025-01-01T14:30:00Z) which will be used for historical traffic times. If not provided, the current date and time will be used. Example: 2026-11-17T14:30:00Z.
- `geometry` (`string`, optional): The format of the geometry in the response. Valid values are linestring, polyline5 and polyline6. linestring returns a GeoJSON LineString, polyline5 returns a polyline with 5 decimal places of precision (compatible with other mapping providers) and polyline6 returns a polyline with 6 decimal places of precision. Defaults to polyline6 if not provided. Example: linestring. One of: `linestring`, `polyline5`, `polyline6`.
- `heading` (`number`, optional): Initial heading of travel where north is 0°, east is 90°, south is 180°, and west is 270°. If not provided, no initial heading will be used. Example: 90.
- `lang` (`string`, optional): Specifies the language for the results. A string, one of de, en, es, fr, ja, ko, pt, ru. Defaults to en. Example: en. One of: `de`, `en`, `es`, `fr`, `ja`, `ko`, `pt`, `ru`.
- `mode` (`string`, optional): The travel mode. A string, one of car, truck, foot, or bike. Defaults to car. Example: car. One of: `car`, `truck`, `foot`, `bike`.
- `units` (`string`, optional): The distance units. A string, metric or imperial. Defaults to imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"locations":"<locations>"}`

### `radar_route_distance`

Route Distance · Read-only

Calculate the travel distance and duration between two points for one or more travel modes.
Returns distance and duration for each mode.
Use Route Matrix for many origins and destinations. Use Directions for turn-by-turn routes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `destination` (`string`, required): The destination. A string in the format latitude,longitude. Example: 40.7041,-73.9867.
- `modes` (`string`, required): The travel modes. A string, comma-separated, including one or more of car, truck, foot, or bike. Example: car,foot.
- `origin` (`string`, required): The origin. A string in the format latitude,longitude. Example: 40.7041,-73.9867.
- `avoid` (`string`, optional): The features that calculated routes should avoid. A string, comma-separated, including one or more of tolls, highways, ferries and borderCrossings. No features are avoided if not provided. Example: tolls,highways.
- `departure_time` (`string`, optional): The date and time of the route provided as an ISO 8601 date string (e.g., 2025-01-01T14:30:00Z) which will be used for historical traffic times. If not provided, the current date and time will be used. Example: 2026-11-17T14:30:00Z.
- `geometry` (`string`, optional): The format of the geometry in the response. Valid values are linestring, polyline5 and polyline6. linestring returns a GeoJSON LineString, polyline5 returns a polyline with 5 decimal places of precision (compatible with other mapping providers) and polyline6 returns a polyline with 6 decimal places of precision. Defaults to none if not provided. Example: linestring. One of: `linestring`, `polyline5`, `polyline6`.
- `units` (`string`, optional): The distance units. A string, metric or imperial. Defaults to imperial if not provided. In the response, distance.value will be in meters for metric and in feet for imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"destination":"<destination>","modes":"<modes>","origin":"<origin>"}`

### `radar_route_match`

Route Match · Read-only

Snap GPS points recorded along a route to the roads most likely traveled.
Returns the matched path, distance and requested road attributes.
Use Directions to plan a route instead.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `path` (`array`, required): Points recorded along the route, each as {"coordinates": "latitude,longitude"} with optional createdAt (ISO date) and accuracy (meters). Sample at least every 10 seconds for best results. Example: [{"coordinates": "40.7041,-73.9867"}, {"coordinates": "40.7050,-73.9860"}].
- `geometry` (`string`, optional): Geometry format: linestring, polyline5 or polyline6 (default). Example: linestring. One of: `linestring`, `polyline5`, `polyline6`.
- `mode` (`string`, optional): Travel mode: car (default), truck, foot or bike. Example: car. One of: `car`, `truck`, `foot`, `bike`.
- `road_attributes` (`string`, optional): Comma-separated road attributes to include: speedLimit, names, roadClass. Example: speedLimit,names.
- `units` (`string`, optional): metric or imperial (default). Example: metric. One of: `metric`, `imperial`.

Example input: `{"path":[{"coordinates":"40.7041,-73.9867"},{"coordinates":"40.7050,-73.9860"}]}`

### `radar_route_matrix`

Route Matrix · Read-only

Calculate travel distances and durations between several origins and destinations.
Returns a matrix with distance and duration for each origin-destination pair.
Use Route Distance for a single pair.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `destinations` (`string`, required): A list of destinations. A pipe-delimited string in the format latitude0,longitude0|latitude1,longitude1|.... Example: 40.7041,-73.9867|40.7484,-73.9857.
- `mode` (`string`, required): The travel mode. A string, one of car, truck, foot, or bike. Example: car. One of: `car`, `truck`, `foot`, `bike`.
- `origins` (`string`, required): A list of origins. A pipe-delimited string in the format latitude0,longitude0|latitude1,longitude1|.... Example: 40.7041,-73.9867|40.7484,-73.9857.
- `avoid` (`string`, optional): The features that calculated routes should avoid. A string, comma-separated, including one or more of tolls, highways and ferries. No features are avoided if not provided. Example: tolls,highways.
- `units` (`string`, optional): The distance units. A string, metric or imperial. Defaults to imperial if not provided. Example: metric. One of: `metric`, `imperial`.

Example input: `{"destinations":"<destinations>","mode":"car","origins":"<origins>"}`

### `radar_route_optimize`

Optimize Route · Read-only

Find the best order to visit up to 10 locations, starting at the first.
Returns the optimized order with distance, duration and geometry.
Use Directions to follow a fixed order.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `locations` (`string`, required): A list of up to 10 coordinates to visit. A pipe-delimited string in the format latitude0,longitude0|latitude1,longitude1|.... The first location should be the origin of the route, and the last location should be the final destination. Example: 40.7041,-73.9867|40.7484,-73.9857.
- `geometry` (`string`, optional): The format of the geometry in the response. Valid values are linestring, polyline5 and polyline6. linestring returns a GeoJSON LineString, polyline5 returns a polyline with 5 decimal places of precision (compatible with other mapping providers) and polyline6 returns a polyline with 6 decimal places of precision. Defaults to none if not provided. Example: linestring. One of: `linestring`, `polyline5`, `polyline6`.
- `mode` (`string`, optional): The travel mode. A string, one of car, truck, foot, or bike. Defaults to car. Example: car. One of: `car`, `truck`, `foot`, `bike`.
- `units` (`string`, optional): The distance units. A string, metric or imperial. Defaults to imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"locations":"<locations>"}`

### `radar_trip_get`

Get Trip · Read-only

Get one trip by Radar _id or externalId.
Returns its status, mode, ETA, destination geofence, user and metadata.
Use List Trips to find trips.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `trip_id` (`string`, required): The trip's Radar _id or externalId. Example: 56db1f4613012711002229f4.

Example input: `{"trip_id":"<trip_id>"}`

### `radar_trips_list`

List Trips · Read-only

List trips, filterable by status, destination geofence, user, delay and date.
Returns trips with external ID, status, mode, ETA, destination and user.
Use Get Trip for one trip.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_after` (`string`, optional): A cursor for use in pagination. Retrieves trips created after the specified datetime. A date or valid ISO date string. Example: 2026-11-01T00:00:00Z.
- `created_before` (`string`, optional): A cursor for use in pagination. Retrieves trips created before the specified datetime. A date or valid ISO date string. Example: 2026-11-16T00:00:00Z.
- `delayed` (`boolean`, optional): Retrieves trips that matches specified delayed state. Example: true.
- `destination_geofence_external_id` (`string`, optional): Retrieves trips with the destination geofence external ID. Example: 123.
- `destination_geofence_tag` (`string`, optional): Retrieves trips with the destination geofence tag. Example: store.
- `include_locations` (`boolean`, optional): Whether to include locations on trips. Defaults to false. Example: false.
- `limit` (`number`, optional): The max number of addresses to return. A number between 1 and 1000. Defaults to 500. Example: 10.
- `sort_by` (`string`, optional): Sorts trips by the specified field in descending order. A string, one of createdAt or updatedAt. Defaults to updatedAt. Example: updatedAt. One of: `createdAt`, `updatedAt`.
- `status` (`string`, optional): Retrieves trips by status. A string, comma-separated including one or more of pending, started, approaching, arrived, completed, canceled, expired. Example: started.
- `user_id` (`string`, optional): The Radar _id of the user for which the trip is being tracked. Example: user-123.

Example input: `{}`

### `radar_user_get`

Get User · Read-only

Get one tracked user by Radar _id, userId or deviceId.
Returns the user's location, device, metadata, current geofences, place, region and trip.
Use List Users to find users.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`string`, required): The user's Radar _id, userId or deviceId. Example: 56db1f4613012711002229f4.

Example input: `{"user_id":"<user_id>"}`

### `radar_users_list`

List Users · Read-only

List tracked users, most recently updated first.
Returns users with ids, location, device, current geofences, place and trip, plus a hasMore flag.
Use updated_before with the last user's updatedAt to page. Use Get User for one user.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`number`, optional): The max number of users to return. A number between 1 and 1000. Defaults to 100. Example: 10.
- `updated_after` (`string`, optional): A cursor for use in pagination. Retrieves users updated after the specified datetime. A date or valid ISO date string. Example: 2026-11-01T00:00:00Z.
- `updated_before` (`string`, optional): A cursor for use in pagination. Retrieves users updated before the specified datetime. A date or valid ISO date string. Example: 2026-11-16T00:00:00Z.

Example input: `{}`

### `radar_autocomplete_select`

Autocomplete Select · Write

Record which Autocomplete result the user picked, closing the autocomplete session.
Returns the selected result.
Use the resultId from an Autocomplete call made with a session token.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `result_id` (`string`, required): The resultId of the chosen result, as returned by the autocomplete endpoint. Results carry one only when the originating search passed a sessionToken. Example: res_8f2a1c.

Example input: `{"result_id":"<result_id>"}`

### `radar_beacon_create`

Create Beacon · Write

Create an iBeacon or Eddystone beacon so the SDK can detect it.
Returns the new beacon.
Use Upsert Beacon to create or replace one by ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `coordinates` (`array`, required): Approximate beacon location as [longitude, latitude], used to sync nearby beacons to the SDK. Example: [-73.9867, 40.7041].
- `description` (`string`, required): A display name for the beacon. Example: Brooklyn store.
- `external_id` (`string`, required): An external ID for the beacon. Example: 123.
- `tag` (`string`, required): A group for the beacon. Example: store.
- `type` (`string`, required): The type of beacon, one of ibeacon (supported on iOS and Android) or eddystone (supported on Android only). Example: ibeacon. One of: `ibeacon`, `eddystone`.
- `enabled` (`boolean`, optional): If true, the beacon will generate events. If false, the beacon will not generate events. Example: true.
- `instance` (`string`, optional): For Eddystone beacons, the instance ID of the beacon. Required for eddystone. Example: a1b2c3d4e5f6.
- `major` (`string`, optional): For iBeacons, the major ID of the beacon. Required for ibeacon. Example: 100.
- `metadata` (`object`, optional): A set of custom key-value pairs for the beacon. A JSON string representing a dictionary with up to 16 keys and values of type string, boolean, or number. Example: {"store_type": "flagship"}.
- `minor` (`string`, optional): For iBeacons, the minor ID of the beacon. Required for ibeacon. Example: 1.
- `uid` (`string`, optional): For Eddystone beacons, the UID of the beacon. Required for eddystone. Example: edd1ebeac04e5defa017.
- `uuid` (`string`, optional): For iBeacons, the UUID of the beacon. Required for ibeacon. Example: B9407F30-F5F8-466E-AFF9-25556B57FE6D.

Example input: `{"coordinates":[-73.9867,40.7041],"description":"<description>","external_id":"<external_id>","tag":"<tag>","type":"ibeacon"}`

### `radar_beacon_upsert`

Upsert Beacon · Write

Create or replace a beacon identified by tag and external ID.
Returns the saved beacon.
Use Create Beacon to always add a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `coordinates` (`array`, required): Approximate beacon location as [longitude, latitude]. Example: [-73.9867, 40.7041].
- `description` (`string`, required): A display name for the beacon. Example: Brooklyn store.
- `external_id` (`string`, required): The beacon external ID within the tag. Example: 123-1.
- `tag` (`string`, required): The beacon tag (its group). Example: store-register.
- `type` (`string`, required): The type of beacon, one of ibeacon (supported on iOS and Android) or eddystone (supported on Android only). Example: ibeacon. One of: `ibeacon`, `eddystone`.
- `enabled` (`boolean`, optional): If true, the beacon will generate events. If false, the beacon will not generate events. Defaults to true. Example: true.
- `instance` (`string`, optional): For Eddystone beacons, the instance ID of the beacon. Required for eddystone. Example: a1b2c3d4e5f6.
- `major` (`string`, optional): For iBeacons, the major ID of the beacon. Required for ibeacon. Example: 100.
- `metadata` (`object`, optional): An optional set of custom key-value pairs for the beacon. A JSON string representing a dictionary with up to 16 keys and values of type string, boolean, or number. Example: {"store_type": "flagship"}.
- `minor` (`string`, optional): For iBeacons, the minor ID of the beacon. Required for ibeacon. Example: 1.
- `uid` (`string`, optional): For Eddystone beacons, the UID of the beacon. Required for eddystone. Example: edd1ebeac04e5defa017.
- `uuid` (`string`, optional): For iBeacons, the UUID of the beacon. Required for ibeacon. Example: B9407F30-F5F8-466E-AFF9-25556B57FE6D.

Example input: `{"coordinates":[-73.9867,40.7041],"description":"<description>","external_id":"<external_id>","tag":"<tag>","type":"ibeacon"}`

### `radar_conversion_log`

Log Conversion · Write

Log a custom conversion event (such as a purchase or check-in) for a user, attributed to their location.
Returns the created event.
Use Track Location to record locations.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The name of the conversion. Should be generic (e.g., in_app_purchase). Only alphanumeric characters and underscores are supported. Example: in_app_purchase.
- `created_at` (`string`, optional): The datetime when the conversion occurred. Example: 2026-11-16T14:30:00Z.
- `device_id` (`string`, optional): A device ID for the user. Used to identify logged out users. Example: C305F2DB-56DC-404F-B6C1-BC52F0B680D8.
- `duration` (`number`, optional): The duration of the conversion in minutes. Example: 12.
- `install_id` (`string`, optional): An install ID for the user. Used to identify users who have opted out of location permissions. Can be a random alphanumeric string for users that don't exist in Radar. Example: 5e4f3a2b-1c0d-4e9f-8a7b-6c5d4e3f2a1b.
- `metadata` (`object`, optional): The metadata of the conversion. This data cannot contain any sensitive or personally identifiable information. Example: {"store_type": "flagship"}.
- `revenue` (`number`, optional): The revenue of the conversion. Used to associate an amount with a transactional conversion such as a purchase or coupon redemption. Example: 12.5.
- `user_id` (`string`, optional): The stable unique ID for the user. Used to identify logged in users. Example: user-123.

Example input: `{"name":"<name>"}`

### `radar_fraud_block`

Block Users or Devices · Write

Block users or devices in Radar Fraud so their location checks fail.
Returns the action with a status URL; association blocking runs asynchronously.
Use Get Fraud Action Status to follow it. Use Unblock Users or Devices to undo.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Users or devices to block, 1 to 500. Each item has exactly one of userId or deviceId, plus optional includeAssociations, durationMs, description, label (fraud or not_fraud), fraudType and incidentTime. Example: [{"userId": "user-123", "description": "Suspicious activity"}].

Example input: `{"items":[{"userId":"user-123","description":"Suspicious activity"}]}`

### `radar_fraud_unblock`

Unblock Users or Devices · Write

Remove fraud blocks from users or devices.
Returns the action with a status URL.
Use Get Fraud Action Status to follow it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Users or devices to unblock, 1 to 500. Each item has exactly one of userId or deviceId, plus optional includeAssociations, label, fraudType and incidentTime. Example: [{"userId": "user-123"}].

Example input: `{"items":[{"userId":"user-123"}]}`

### `radar_geofence_upsert`

Upsert Geofence · Write

Create or replace a geofence identified by tag and external ID, as a circle, polygon or isochrone.
Returns the saved geofence.
Use List Geofences to see existing ones. Use Delete Geofence to remove one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `description` (`string`, required): A description for the geofence. Example: Brooklyn store.
- `external_id` (`string`, required): The geofence external ID within the tag. Example: 123.
- `tag` (`string`, required): The geofence tag (its group). Example: store.
- `type` (`string`, required): The type of geofence geometry. A string, one of circle, polygon, or isochrone. Example: circle. One of: `circle`, `polygon`, `isochrone`.
- `address` (`string`, optional): An address to search for, and if found, will represent the center for type circle or isochrone. If address and coordinates are both provided, they must be nearby, and coordinates will take precedent. Ignored for type polygon. Required if coordinates and placeid are not included. Example: 20 Jay St, Brooklyn, NY.
- `coordinates` (`array`, optional): Center (circle) or destination (isochrone) as [longitude, latitude], or polygon vertices as an array of [longitude, latitude] pairs. Required if address and place_id are not given. Example: [-73.9867, 40.7041].
- `delete_after` (`string`, optional): Use to create temporary geofences. If set, the geofence will be deleted after the specified datetime. A date or valid ISO date string. Example: 2026-12-31T00:00:00Z.
- `disable_after` (`string`, optional): Use to create temporary geofences. If set, the geofence will be disabled after the specified datetime. A date or valid ISO date string. Example: 2026-12-01T00:00:00Z.
- `dwell_threshold` (`number`, optional): An optional field to trigger dwell events. If set and user.dwelled_in_geofence is enabled in settings, an event is triggered when a user dwells in the geofence longer than the threshold (in minutes). Example: 10.
- `enabled` (`boolean`, optional): If true, the geofence will generate events. If false, the geofence will not generate events. Defaults to true. Example: true.
- `ip` (`string`, optional): An optional IP address restriction for the geofence. A string of comma-separated IP address ranges, each of which could be a single IP (8.8.8.8), wildcard notation (8.8.8.*), or CIDR notation (8.8.8.8/24). If set, the geofence will only generate events for requests from the specified IP address. If not set, the geofence will generate events for all requests. Example: 203.0.113.0/24.
- `metadata` (`object`, optional): An optional set of custom key-value pairs for the geofence. A dictionary or JSON string with up to 16 keys and values of type string, boolean, or number. Example: {"store_type": "flagship"}.
- `mode` (`string`, optional): The travel mode for type isochrone. Required for type isochrone. Example: car. One of: `car`, `foot`, `bike`.
- `operating_hours` (`object`, optional): An optional set of key-value pairs restricting the operating hours of the geofence. Each key is a day of the week (e.g., Sunday) or the three letter abbreviation of the day (e.g., Sun), case insensitive. Each value is a list of pairs, where a pair indicates one opening and closing time for that day. For example, a restaurant only open for lunch and dinner on Sundays would be { Sunday: [["11:00", "14:00"], ["19:00", "22:00"]] }. Accepted time formats include h:mm aa (e.g., 12:45 AM) and HH:mm (e.g., 00:45). If not set, the geofence will always be open. Example: {"Mon": [["09:00", "17:00"]]}.
- `place_id` (`string`, optional): For place matching, an optional id of the Radar place to match to the geofence. If provided and found, the place centroid will override coordinates and address. Required if coordinates and address are not included. Example: 59302bcf8f27e9c0adf3fd5c.
- `radius` (`number`, optional): The radius in meters for type circle, a number between 10 and 10000. The travel duration in minutes for type isochrone. Ignored for type polygon. Required for type circle and isochrone. Example: 100.
- `stop_detection` (`boolean`, optional): The stop detection setting for the geofence. Overrides the project-level stop detection setting. Example: true.
- `trip_approaching_threshold` (`number`, optional): The trip approaching threshold setting for the geofence (in minutes). Overrides the project-level trip approaching threshold setting. Example: 5.
- `user_id` (`string`, optional): An optional user restriction for the geofence. If set, the geofence will only generate events for the specified user. If not set, the geofence will generate events for all users. **Deprecated.**. Example: user-123.
- `user_ids` (`string`, optional): An optional user restriction for the geofence. A string of comma-separated user IDs. If set, the geofence will only generate events for the specified users. If not set, the geofence will generate events for all users. Example: user-123,user-456.

Example input: `{"description":"<description>","external_id":"<external_id>","tag":"<tag>","type":"circle"}`

### `radar_places_settings_update`

Update Places Settings · Write

Update the project's Places settings: chain metadata, chain mappings and place filters.
Returns the updated settings.
Use Get Places Settings to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `chain_mappings` (`object`, optional): Map of chain slug to your own identifier. Example: {"mcdonalds": "retailer1"}.
- `chain_metadata` (`object`, optional): Chain metadata keyed by chain slug. Example: {"mcdonalds": {"availableDeals": false}}.
- `place_filters` (`object`, optional): Place filters, for example chain slugs to include. Example: {"chain": ["mcdonalds"]}.

Example input: `{}`

### `radar_track`

Track Location · Write

Record a location update for a user or device from your server, creating the user if needed.
Returns the user and any events generated (geofence entries and exits, trip updates, place visits).
Use List Users or Get User to read users without sending a location.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `accuracy` (`number`, required): The accuracy of the user's current latitude and longitude, in meters. A number greater than 0. Used when evaluating the confidence of geofence events. Example: 10.
- `device_id` (`string`, required): A device ID for the user. Used to identify logged out users. Example: C305F2DB-56DC-404F-B6C1-BC52F0B680D8.
- `latitude` (`number`, required): The user's current latitude. A number between -90 and 90. Example: 40.7041.
- `longitude` (`number`, required): The user's current longitude. A number between -180 and 180. Example: -73.9867.
- `altitude` (`number`, optional): An altitude in meters. Example: 15.
- `description` (`string`, optional): An optional description for the user, displayed in the dashboard. Example: Brooklyn store.
- `device_make` (`string`, optional): The manufacturer of the device. Example: Apple.
- `device_model` (`string`, optional): The model of the device. Example: iPhone15,2.
- `device_os` (`string`, optional): The operating system of the device. Example: 17.4.
- `device_type` (`string`, optional): The user's device type, one of iOS, Android, or Web. Example: iOS. One of: `iOS`, `Android`, `Web`.
- `foreground` (`boolean`, optional): true if the client is in the foreground, false if the client is in the background. Example: true.
- `metadata` (`object`, optional): An optional dictionary of custom metadata for the user. Up to 32 keys and values of type string, boolean, or number. Example: {"store_type": "flagship"}.
- `replayed` (`boolean`, optional): true if the location is replayed, false if the location is not replayed. Defaults to false. Example: false.
- `stopped` (`boolean`, optional): true if the user is stopped, false if the user is moving. Example: false.
- `updated_at` (`string`, optional): The client timestamp or historical timestamp when the user's location was updated. Historical data must be upserted in chronological order. Optional, defaults to the current server timestamp if not provided or not in chronological order. A date or valid ISO date string. Example: 2026-11-16T14:30:00Z.
- `user_id` (`string`, optional): A stable unique ID for the user. Used with deviceId to identify logged in users. Not required for logged out users. Example: user-123.
- `vertical_accuracy` (`number`, optional): A vertical accuracy in meters. Example: 5.

Example input: `{"accuracy":10,"device_id":"<device_id>","latitude":40.7041,"longitude":-73.9867}`

### `radar_trip_create`

Create Trip · Write

Start tracking a trip for a user toward a destination geofence, such as a pickup or delivery.
Returns the new trip with status and ETA.
Use Update Trip to change its status. Use Delete Trip to remove it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `external_id` (`string`, required): A stable unique ID for the trip. Depending on your use case, it may represent an order ID, a delivery ID, or something else. Example: 123.
- `approaching_threshold` (`number`, optional): For trips with a destination, the trip approaching threshold setting for the trip (in minutes). Overrides the geofence-level and project-level trip approaching threshold settings. Example: 5.
- `destination_geofence_external_id` (`string`, optional): For trips with a destination, the external ID of the destination geofence. Example: 123.
- `destination_geofence_tag` (`string`, optional): For trips with a destination, the tag of the destination geofence. Example: store.
- `metadata` (`object`, optional): An optional set of custom key-value pairs for the trip. Example: {"store_type": "flagship"}.
- `mode` (`string`, optional): The travel mode for the trip. A string, one of foot, bike, and car. Defaults to car. Example: car. One of: `foot`, `bike`, `car`.
- `scheduled_arrival_at` (`string`, optional): Required for the Olo order firing integration, the backstop datetime when the device on the trip is expected to arrive. The order will be fired approachingThreshold minutes before scheduledArrivalAt. Example: 2026-11-16T18:00:00Z.
- `user_id` (`string`, optional): The external ID of the user for which the trip is being tracked. Example: user-123.

Example input: `{"external_id":"<external_id>"}`

### `radar_trip_update`

Update Trip · Write

Change a trip's status (for example to completed or canceled), mode, destination or metadata.
Returns the updated trip.
Use Get Trip to read the current state.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `status` (`string`, required): The new status of the trip, one of pending,started, approaching, arrived, completed, or canceled. Example: started. One of: `pending`, `started`, `approaching`, `arrived`, `completed`, `canceled`.
- `trip_id` (`string`, required): The trip's Radar _id or externalId. Example: 56db1f4613012711002229f4.
- `approaching_threshold` (`number`, optional): For trips with a destination, the trip approaching threshold setting for the trip (in minutes). Overrides the geofence-level and project-level trip approaching threshold settings. Example: 5.
- `destination_geofence_external_id` (`string`, optional): For trips with a destination, the external ID of the destination geofence. Example: 123.
- `destination_geofence_tag` (`string`, optional): For trips with a destination, the tag of the destination geofence. Example: store.
- `metadata` (`object`, optional): An optional set of custom key-value pairs for the trip. Example: {"store_type": "flagship"}.
- `mode` (`string`, optional): The travel mode for the trip. A string, one of foot, bike, and car. Example: car. One of: `foot`, `bike`, `car`.
- `scheduled_arrival_at` (`string`, optional): Required for the Olo order firing integration, the backstop datetime when the device on the trip is expected to arrive. The order will be fired approachingThreshold minutes before scheduledArrivalAt. Example: 2026-11-16T18:00:00Z.

Example input: `{"status":"pending","trip_id":"<trip_id>"}`

### `radar_users_refresh`

Request Location Refresh · Write

Ask up to 10 users' devices to send a fresh location through a silent push.
Returns the request result; devices then call track.
Needs silent push set up in the Radar project and SDK.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `user_ids` (`array`, required): An array of user IDs to send the track request to. Limit to a maximum of 10 users per request. Example: ["user-123"].
- `type` (`string`, optional): Choose which type of notification is used, one of silentPush or pushExtension. Example: silentPush. One of: `silentPush`, `pushExtension`.

Example input: `{"user_ids":["user-123"]}`

### `radar_beacon_delete`

Delete Beacon · Destructive

Delete a beacon by its Radar _id.
Returns a confirmation.
Use List Beacons to find the _id.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `beacon_id` (`string`, required): The beacon's Radar _id. Example: 6109a4b16dbfe3de2cb03924.

Example input: `{"beacon_id":"<beacon_id>"}`

### `radar_geofence_delete`

Delete Geofence · Destructive

Delete a geofence by its Radar _id.
Returns a confirmation.
Use Get Geofence by External ID to find the _id from a tag and external ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `geofence_id` (`string`, required): The geofence's Radar _id. Example: 56db1f4613012711002229f5.

Example input: `{"geofence_id":"<geofence_id>"}`

### `radar_trip_delete`

Delete Trip · Destructive

Delete a trip.
Returns a confirmation.
Use Update Trip with status canceled to keep the record instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `trip_id` (`string`, required): The trip's Radar _id or externalId. Example: 56db1f4613012711002229f4.

Example input: `{"trip_id":"<trip_id>"}`

### `radar_user_delete`

Delete User · Destructive

Delete a tracked user and their location data.
Returns a confirmation.
Use Get User to check the user first.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`string`, required): The user's Radar _id, userId or deviceId. Example: 56db1f4613012711002229f4.

Example input: `{"user_id":"<user_id>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
