---
title: "Create SNMP trap mapping"
method: POST
path: "/v1/snmp-trap-mappings"
tags: ["SNMP Trap Mappings"]
---

# Create SNMP trap mapping

`POST /v1/snmp-trap-mappings`

Create a new SNMP trap mapping. Requires CONFIGURE_TRAPS system access right. If `eventCode`
is not provided, trap is mapped to `SNMP_UNMATCHED_TRAP` event.

## Request body

- object
  - `oid` string, required — Trap OID in dotted notation.
  - `eventCode` integer — Code of the event generated for matching trap (must refer to existing event template).
  - `eventTag` string, nullable — Tag added to generated event.
  - `description` string — Trap mapping description.
  - `transformationScript` string — NXSL transformation script source.
  - `parameters` SnmpTrapParameterMapping[] — Parameter mappings. Replaces all existing parameter mappings when provided.
    - `id` integer — Parameter number (1-based position in the parameter list). Ignored on input.
    - `oid` string — OID of the varbind (for mapping by OID).
    - `position` integer — Varbind position (for mapping by position). Takes precedence over `oid` when positive.
    - `description` string — Parameter description.
    - `flags` integer — Parameter mapping flags (bit 0 - force text representation of value).

## Response `201`

SNMP trap mapping created successfully.

- SnmpTrapMapping
  - `id` integer — SNMP trap mapping ID.
  - `guid` string, uuid — SNMP trap mapping GUID.
  - `oid` string — Trap OID. Traps are matched by exact OID or by longest matching OID prefix.
  - `eventCode` integer — Code of the event generated for matching trap.
  - `eventTag` string, nullable — Tag added to generated event.
  - `description` string — Trap mapping description.
  - `transformationScript` string — NXSL transformation script source.
  - `parameters` SnmpTrapParameterMapping[] — Parameter mappings (omitted if there are none).
    - `id` integer — Parameter number (1-based position in the parameter list). Ignored on input.
    - `oid` string — OID of the varbind (for mapping by OID).
    - `position` integer — Varbind position (for mapping by position). Takes precedence over `oid` when positive.
    - `description` string — Parameter description.
    - `flags` integer — Parameter mapping flags (bit 0 - force text representation of value).

## Other responses

- `400` — Invalid request (missing or invalid OID, invalid parameter mapping, unknown event code, invalid field type, or value too long).
- `401` — Unauthorized.
- `403` — Access denied.
- `500` — Database failure.

## Changes

- **2026-09-30** `d3ebef46a35c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/snmp-trap-mappings/post.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/129789f8868f?raw)