SAsamsara
Trailers

Creates a new trailer asset

Creates a new trailer asset.

<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 Trailers under the Trailers 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/fleet/trailers

Request

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

Request body

enabledForMobileboolean

Indicates if the trailer is visible on the Samsara mobile apps.

externalIdsobject

A map of external ids

licensePlatestring

The license plate of the Trailer. By default: empty. Can be set or updated through the Samsara Dashboard or the API at any time.

namestring required

The human-readable name of the Trailer. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. By default, this name is the serial number of the Samsara Asset Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time.

notesstring

These are generic notes about the Trailer. Empty by default. Can be set or updated through the Samsara Dashboard or the API at any time.

tagIdsstring[]

An array of IDs of tags to associate with this trailer. If your access to the API is scoped by one or more tags, this field is required to pass in.

trailerSerialNumberstring

The serial number of the trailer.

Example request

{
  "attributes": [
    {
      "dateValues": [
        "2024-01-15",
        "2024-12-31"
      ],
      "id": "494123",
      "name": "Compliance/ELD",
      "numberValues": [
        867,
        5309
      ],
      "stringValues": [
        "HQ",
        "Leased"
      ]
    }
  ],
  "enabledForMobile": true,
  "licensePlate": "7TYP290",
  "name": "Trailer-123",
  "notes": "These are my trailer notes",
  "tagIds": [
    "Placeat est voluptatem id tenetur amet.",
    "Omnis consectetur quis neque nihil molestiae harum."
  ],
  "trailerSerialNumber": "8V8WD530FLN016251"
}

Response

OK response.

Example response

{
  "data": {
    "attributes": [
      {
        "dateValues": [
          "2024-01-15",
          "2024-12-31"
        ],
        "id": "494123",
        "name": "Compliance/ELD",
        "numberValues": [
          867,
          5309
        ],
        "stringValues": [
          "HQ",
          "Leased"
        ]
      }
    ],
    "enabledForMobile": true,
    "id": "494123",
    "installedGateway": {
      "model": "VG34",
      "serial": "GFRV-43N-VGX"
    },
    "licensePlate": "7TYP290",
    "name": "Trailer-123",
    "notes": "These are my trailer notes",
    "tags": [
      {
        "id": "3914",
        "name": "East Coast",
        "parentTagId": "4815"
      }
    ],
    "trailerSerialNumber": "8V8WD530FLN016251"
  }
}

Changes

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