---
title: "[beta] Create an asset assignment."
method: POST
path: "/fleet/assets/assignments"
tags: ["Beta APIs"]
---

# \[beta\] Create an asset assignment.

`POST /fleet/assets/assignments`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/assets/assignments`
- Auth: HTTP bearer

Create an asset assignment.

 <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 Assignments** under the Assignments 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.

## Request body

- AssetAssignmentsCreateAssetAssignmentRequestBody: Asset assignment to create.
  - `assetId` string, required: Samsara ID of the asset.
  - `assigneeId` string, required: Samsara ID of the assignee.
  - `assigneeType` 'driver' | 'asset' | 'geofence', required: Type of the assignee. This required field has no default. Valid values: `driver`, `asset`, `geofence`
  - `expectedEndTime` string, date-time: Optional. The expected end time of the assignment in RFC 3339 format. Must be strictly after the current time.

## Response `200`

OK response.

- AssetAssignmentsCreateAssetAssignmentResponseBody
  - `data` AssetAssignmentResponseObjectResponseBody, required: Asset assignment object.
    - `asset` AssetResponseResponseBody, required: Asset that the location readings are tied to.
      - `externalIds` object: A map of external ids
      - `id` string, required: ID of the asset
    - `assignee` AssetAssignmentAssigneeResponseObjectResponseBody, required: Assignee for an asset assignment.
      - `assigneeType` 'unknown' | 'driver' | 'asset' | 'geofence' | 'job', required: Type of the assignee. Valid values: `unknown`, `driver`, `asset`, `geofence`, `job`
      - `externalIds` object: A map of external ids for the assignee.
      - `id` string, required: ID of the assignee.
    - `endTime` string, date-time: The end time of the assignment in RFC 3339 format, if the assignment has ended.
    - `expectedEndTime` string, date-time: The expected end time of the assignment in RFC 3339 format, if one was set at creation. Values may be in the past for listed active assignments whose expected return has elapsed.
    - `startTime` string, date-time, required: The start time of the assignment in RFC 3339 format.

## 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)