SAsamsara
Fuel and Energy

Create a preferred fuel station.

Create a preferred fuel station for your organization.

<b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select Write Fuel Purchase under the Fuel & Energy category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

post/preferred-stations

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Request body

externalIdsobject required

Map of source-system key to customer-provided station ID.

latitudenumber double

Latitude in WGS84 degrees.

longitudenumber double

Longitude in WGS84 degrees.

namestring required

Display name of the station.

Example request

{
  "address": {
    "city": "Green River",
    "country": "US",
    "line1": "8901 US Hwy 374",
    "postalCode": "82935",
    "state": "WY"
  },
  "discounts": [
    {
      "discount": {
        "amount": "640.2",
        "currency": "usd"
      },
      "discountPercent": "3.5",
      "discountType": "centsPerUnit",
      "fuelType": "diesel",
      "volumeUnit": "gallon"
    }
  ],
  "latitude": 41.5168,
  "longitude": -109.471,
  "name": "Station #432",
  "prices": [
    {
      "fuelType": "diesel",
      "grossPrice": {
        "amount": "640.2",
        "currency": "usd"
      },
      "netPrice": {
        "amount": "640.2",
        "currency": "usd"
      },
      "volumeUnit": "gallon"
    }
  ]
}

Response

OK response.

Example response

{
  "data": {
    "address": {
      "city": "Green River",
      "country": "US",
      "line1": "8901 US Hwy 374",
      "postalCode": "82935",
      "state": "WY"
    },
    "discounts": [
      {
        "discount": {
          "amount": "640.2",
          "currency": "usd"
        },
        "discountPercent": "3.5",
        "discountType": "centsPerUnit",
        "fuelType": "diesel",
        "volumeUnit": "gallon"
      }
    ],
    "id": "sta_abc123",
    "latitude": 41.5168,
    "longitude": -109.471,
    "name": "Pilot Travel Center #432",
    "prices": [
      {
        "fuelType": "diesel",
        "grossPrice": {
          "amount": "640.2",
          "currency": "usd"
        },
        "netPrice": {
          "amount": "640.2",
          "currency": "usd"
        },
        "volumeUnit": "gallon"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.