---
title: "Create Action Request On Specific UDP Device."
method: POST
path: "/v1/integrate/devices/{deviceId}/actions/UDP"
tags: ["IoT Integrator"]
---

# Create Action Request On Specific UDP Device.

`POST /v1/integrate/devices/{deviceId}/actions/UDP`

## Request

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

Initiate UDP action on specific device.

## Path parameters

- `deviceId` string, required

## Request body

- Postschema3: Post UDP device action.
  - `payload` string, required: Data that should be sent to a device
  - `payloadType` 'STRING' | 'BASE64', required: Type of the payload
  - `port` integer, required: Communication port number of a device
  - `requestMode` 'SEND_NOW' | 'SEND_WHEN_ACTIVE': Action request execution mode

## Response `202`

Message describing the result of operation

- PostResponseschema: Post device action response.
  - `id` string, required: Id of the created action request
  - `message` string, required: Message describing the result of operation.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `409`: Conflict
- `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)