--- title: "Creates a new trailer asset" method: POST path: "/fleet/trailers" tags: ["Trailers"] --- # Creates a new trailer asset `POST /fleet/trailers` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/fleet/trailers` - Auth: HTTP bearer Creates a new trailer asset. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Trailers** under the Trailers category when creating or editing an API token. Learn More. **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. ## Request body - TrailersCreateTrailerRequestBody - `attributes` GoaAttributeTinyRequestBody[]: A list of attributes to assign to the trailer. - `dateValues` string[]: List of date values associated with the attribute (RFC 3339 full-date format: YYYY-MM-DD). - `id` string: Id of the attribute - `name` string: Name of the attribute - `numberValues` number[]: List of number values associated with the attribute - `stringValues` string[]: List of string values associated with the attribute. - `enabledForMobile` boolean: Indicates if the trailer is visible on the Samsara mobile apps. - `externalIds` object: A map of external ids - `licensePlate` string: The license plate of the Trailer. **By default**: empty. Can be set or updated through the Samsara Dashboard or the API at any time. - `name` string, 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. - `notes` string: 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. - `tagIds` string[]: 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. - `trailerSerialNumber` string: The serial number of the trailer. ## Response `200` OK response. - TrailersCreateTrailerResponseBody - `data` TrailerWithAttributesResponseObjectResponseBody, required - `attributes` GoaAttributeTinyResponseBody[]: List of attributes associated with the entity - `dateValues` string[]: List of date values associated with the attribute (RFC 3339 full-date format: YYYY-MM-DD). - `id` string: Id of the attribute - `name` string: Name of the attribute - `numberValues` number[]: List of number values associated with the attribute - `stringValues` string[]: List of string values associated with the attribute. - `enabledForMobile` boolean: Indicates if the trailer is visible on the Samsara mobile apps. - `externalIds` object: A map of external ids - `id` string, required: The unique Samsara ID of the Trailer. This is automatically generated when the Trailer object is created. It cannot be changed. - `installedGateway` TrailerGoaGatewayTinyResponseResponseBody: A minified gateway object. This field will be omitted if the trailer does not have a gateway installed. - `model` 'AG15' | 'AG24' | 'AG24EU' | 'AG26' | 'AG26EU' | 'AG41' | 'AG41EU' | 'AG45' | 'AG45EU' | 'AG46' | 'AG46EU' | 'AG46P' | 'AG46PEU' | 'AG51' | 'AG51EU' | 'AG52' | 'AG52EU' | 'AG53' | 'AG53EU' | 'AT11' | 'AT11X' | 'AT12' | 'AT12X' | 'AT13' | 'IG15' | 'IG21' | 'IG41' | 'IG61' | 'SG1' | 'SG1B' | 'SG1G' | 'SG1G32' | 'SG1x' | 'VG32' | 'VG33' | 'VG34' | 'VG34EU' | 'VG34FN' | 'VG34M' | 'VG54ATT' | 'VG54EU' | 'VG54FN' | 'VG54NA' | 'VG54NAE' | 'VG54NAH' | 'VG55EU' | 'VG55FN' | 'VG55NA', required: The model of the gateway installed on the asset. Valid values: `AG15`, `AG24`, `AG24EU`, `AG26`, `AG26EU`, `AG41`, `AG41EU`, `AG45`, `AG45EU`, `AG46`, `AG46EU`, `AG46P`, `AG46PEU`, `AG51`, `AG51EU`, `AG52`, `AG52EU`, `AG53`, `AG53EU`, `AT11`, `AT11X`, `AT12`, `AT12X`, `AT13`, `IG15`, `IG21`, `IG41`, `IG61`, `SG1`, `SG1B`, `SG1G`, `SG1G32`, `SG1x`, `VG32`, `VG33`, `VG34`, `VG34EU`, `VG34FN`, `VG34M`, `VG54ATT`, `VG54EU`, `VG54FN`, `VG54NA`, `VG54NAE`, `VG54NAH`, `VG55EU`, `VG55FN`, `VG55NA` - `serial` string, required: The serial number of the gateway installed on the asset. - `licensePlate` string: The license plate of the Trailer. **By default**: empty. Can be set or updated through the Samsara Dashboard or the API at any time. - `name` string: 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. - `notes` string: 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. - `tags` GoaTagTinyResponseResponseBody[]: The list of [tags](https://kb.samsara.com/hc/en-us/articles/360026674631-Using-Tags-and-Tag-Nesting) associated with the Trailer. - `id` string, required: ID of the tag - `name` string, required: Name of the tag. - `parentTagId` string: If this tag is part a hierarchical tag tree, this is the ID of the parent tag, otherwise this will be omitted. - `trailerSerialNumber` string: The serial number of the trailer. ## Other responses - `401`: Unauthorized response. - `404`: Not Found response. - `405`: Method Not Allowed response. - `413`: Content Too Large response. - `429`: Too Many Requests response. - `500`: Internal Server Error response. - `501`: Not Implemented response. - `502`: Bad Gateway response. - `503`: Service Unavailable response. - `504`: Gateway Timeout response. - `default`: Bad Request response. --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)