View as Markdown
Samsara icon

Samsara ACTION

Create Address

Adds a new address to the organization. The user must provide the necessary props such as formatted address, geofence, and name. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Samsara account once, then configure and run Create Address from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "samsara-create-address",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    samsara: { authProvisionId: "apn_xxxxxxx" },
    addressTypes: ["Address Types"],
    contactIds: ["Contact Ids"],
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Address inputs
Property Type Description
addressTypes Address Types string[]
Reporting location type associated with the address (used for ELD reporting purposes).
Optional
contactIds Contact Ids string[]
An array of Contact IDs associated with this Address.
Optional Dynamic
externalIds External Ids object
The external IDs for the given object.
Optional
formattedAddress Formatted Address string
The full street address for this address/geofence, as it might be recognized by Google Maps.
Required
geofence Geofence object
The geofence that defines this address and its bounds. This can either be a circle or a polygon, but not both. See the documentation
Required
latitude Latitude string
Latitude of the address. Will be geocoded from Formatted Address if not provided.
Optional
longitude Longitude string
Longitude of the address. Will be geocoded from Formatted Address if not provided.
Optional
name Name string
Name of the address.
Required
notes Notes string
Notes about the address.
Required
tagIds Tag Ids string[]
An array of IDs of tags to associate with this address.
Optional Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
samsara-create-address
Version
0.0.2
App
Samsara
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes