---
title: "Activate a new gateway"
method: POST
path: "/gateways"
tags: ["Gateways"]
---

# Activate a new gateway

`POST /gateways`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/gateways`
- Auth: HTTP bearer

Activate a new gateway. To activate a device and associate it with your organization, enter its serial number. Each device's serial number can also be found on its label or packaging, or from your order confirmation email. A Not Found error could mean that the serial was not found or it has already been activated

 <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 Gateways** under the Setup & Administration 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

- GatewaysPostGatewayRequestBody
  - `serial` string, required: Gateway serial number

## Response `200`

OK response.

- GatewaysPostGatewayResponseBody
  - `data` GatewayResponseObjectResponseBody, required
    - `accessoryDevices` AccessoryResponseObjectResponseBody[]: Accessory devices on gateway
      - `model` string: Product model name of the device
      - `serial` string: The serial number of the accessory device.
    - `asset` GatewayAssetResponseObjectResponseBody: An object containing information about the asset the gateway is installed on
      - `externalIds` object: A map of external ids
      - `id` string: The unique Samsara ID of the asset where the gateway is installed. This is automatically generated when the asset is created and cannot be changed. Use this ID on PATCH vehicle, equipment, or trailer endpoints to update the asset
    - `connectionStatus` ConnectionStatusResponseObjectResponseBody: An objecting containing information about the connectivity status of the gateway
      - `healthStatus` 'Status Not Set' | 'Connected' | 'Not Installed' | 'Power Source Off - Active Vehicle' | 'Power Source Off - Inactive Vehicle' | 'Weak Cellular Signal' | 'Requires Investigation' | 'Requires Charge' | 'Unsupported Product' | 'Low Battery. Replace Device.' | 'Low Vehicle Battery' | 'Unplugged' | 'Low Charging State' | 'Vehicle Off' | 'Weak GPS Signal' | 'Low Gateway Battery' | 'Low Gateway Battery (AG24)' | 'Low Gateway Battery (AG45)' | 'Low Gateway Battery (AG26)' | 'Low Gateway Battery (AG46)' | 'Low Gateway Battery (AG46-P)' | 'Temporarily Offline' | 'Prolonged Offline' | 'Recently Offline' | 'Replacement Required' | 'Status Unknown': The most recent health status of the gateway. Valid values: `Status Not Set`, `Connected`, `Not Installed`, `Power Source Off - Active Vehicle`, `Power Source Off - Inactive Vehicle`, `Weak Cellular Signal`, `Requires Investigation`, `Requires Charge`, `Unsupported Product`, `Low Battery. Replace Device.`, `Low Vehicle Battery`, `Unplugged`, `Low Charging State`, `Vehicle Off`, `Weak GPS Signal`, `Low Gateway Battery`, `Low Gateway Battery (AG24)`, `Low Gateway Battery (AG45)`, `Low Gateway Battery (AG26)`, `Low Gateway Battery (AG46)`, `Low Gateway Battery (AG46-P)`, `Temporarily Offline`, `Prolonged Offline`, `Recently Offline`, `Replacement Required`, `Status Unknown`
      - `lastConnected` string: The last time the gateway was connected in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
    - `dataUsageLast30Days` DataUsageResponseObjectResponseBody: An object containing information about the gateway data usage in mb for the last 30 days.
      - `cellularDataUsageBytes` integer: Celluar data usage in bytes.
      - `hotspotUsageBytes` integer: Wifi hotspot data usage in bytes.
    - `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.

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