---
title: "Create Action Requests for UDP Devices."
method: POST
path: "/v1/integrate/devices/actions/UDP"
tags: ["IoT Integrator"]
---

# Create Action Requests for UDP Devices.

`POST /v1/integrate/devices/actions/UDP`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/devices/actions/UDP`
- Auth: HTTP bearer

Initiate UDP action on devices.

## Request body

- BulkPostschema2: Bulk Post UDP device action.
  - `deviceIds` string[], required: Devices that should receive the data
  - `payload` string, required: Data that should be sent to the devices
  - `payloadType` 'STRING' | 'BASE64', required: Type of the payload
  - `port` integer, required: Communication port number of the devices
  - `requestMode` 'SEND_NOW' | 'SEND_WHEN_ACTIVE': Action request execution mode

## Response `202`

Message describing the result of operation

- BulkPostResponseschema: Post device action response.
  - `acceptedRequests` BulkPostResponseschemaAcceptedRequestsInner[], required: successfully created action requests
    - `deviceId` string: Id of the device.
    - `requestId` string: Id of the request.
  - `rejectedDevices` string[], required: A list of devices for which it was not possible to send data.
  - `message` string, required: Message describing the result of operation.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)
