Create an address

Creates a new address in the organization.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

To use this endpoint, select Write Addresses under the Addresses category when creating or editing an API token. Learn More.

POST /addresses

Create an address

cURL

curl --request POST \
  --url https://api.samsara.com/addresses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "formattedAddress": "350 Rhode Island St, San Francisco, CA",
  "geofence": {
    "settings": {
      "showAddresses": true
    }
  },
  "name": "Samsara HQ",
  "addressTypes": [
    "yard"
  ],
  "contactIds": [
    "22408"
  ],
  "externalIds": {
    "maintenanceId": "250020",
    "payrollId": "ABFS18600"
  },
  "latitude": 37.765363,
  "longitude": -122.4029238,
  "notes": "Hours of operation: 8am - 6pm; Truck entrance on the Rhode Island street side.",
  "tagIds": [
    "3914"
  ]
}
'

200

{
  "data": {
    "formattedAddress": "350 Rhode Island St, San Francisco, CA",
    "geofence": {
      "circle": {
        "radiusMeters": 25,
        "latitude": 37.765363,
        "longitude": -122.4029238
      },
      "polygon": {
        "vertices": [
          {
            "latitude": 37.765363,
            "longitude": -122.403098
          },
          {
            "latitude": 38.765363,
            "longitude": -122.403098
          },
          {
            "latitude": 37.765363,
            "longitude": -123.403098
          }
        ]
      },
      "settings": {
        "showAddresses": false
      }
    },
    "id": "22408",
    "name": "Samsara HQ",
    "addressTypes": [
      "yard"
    ],
    "contacts": [
      {
        "firstName": "Jane",
        "id": "22408",
        "lastName": "Jones"
      }
    ],
    "createdAtTime": "2019-05-18T20:27:35Z",
    "externalIds": {
      "maintenanceId": "250020",
      "payrollId": "ABFS18600"
    },
    "latitude": 37.765363,
    "longitude": -122.4029238,
    "notes": "Hours of operation: 8am - 6pm; Truck entrance on the Rhode Island street side.",
    "tags": [
      {
        "id": "3914",
        "name": "East Coast",
        "parentTagId": "4815"
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The address to create.

A request body to create an Address.

formattedAddress · string · required

The full street address for this address/geofence, as it might be recognized by Google Maps.

Maximum string length: 1024

Example:

"350 Rhode Island St, San Francisco, CA"

geofence · object · required

The geofence that defines this address and its bounds. This can either be a circle or a polygon, but not both.

Show child attributes

name · string · required

Name of the address.

Maximum string length: 255

Example:

"Samsara HQ"

addressTypes · enum<string>[]

Reporting location type associated with the address (used for ELD reporting purposes). Valid values: yard, shortHaul, workforceSite, riskZone, industrialSite, alertsOnly, agricultureSource, avoidanceZone, knownGPSJammingZone, authorizedZone, unauthorizedZone, vendor, inventory.

Available options: yard, shortHaul, workforceSite, riskZone, industrialSite, alertsOnly, agricultureSource, avoidanceZone, knownGPSJammingZone, authorizedZone, unauthorizedZone, vendor, inventory

contactIds · string[]

An array of Contact IDs associated with this Address.

externalIds · object

The external IDs for the given object.

Show child attributes

Example:

{
  "maintenanceId": "250020",
  "payrollId": "ABFS18600"
}

latitude · number<double>

Latitude of the address. Will be geocoded from formattedAddress if not provided.

Example:

37.765363

longitude · number<double>

Longitude of the address. Will be geocoded from formattedAddress if not provided.

Example:

-122.4029238

notes · string

Notes about the address.

Maximum string length: 280

Example:

"Hours of operation: 8am - 6pm; Truck entrance on the Rhode Island street side."

tagIds · string[]

An array of IDs of tags to associate with this address.

Response

200

application/json

Newly created address object with ID.

An Address response body.

data · object · required

An Address object.

Show child attributes