---
title: "POST /connector-event/{ConnectorId}"
method: POST
path: "/connector-event/{ConnectorId}"
---

# POST /connector-event/{ConnectorId}

`POST /connector-event/{ConnectorId}`

Relays third-party device events for a connector such as a new device or a device state change event.

## Path parameters

- `ConnectorId` string, required

## Request body

- object
  - `UserId` string, password — The id of the third-party cloud provider.
  - `Operation` 'DEVICE_COMMAND_RESPONSE' | 'DEVICE_DISCOVERY' | 'DEVICE_EVENT' | 'DEVICE_COMMAND_REQUEST', required — <p>The Open Connectivity Foundation (OCF) operation requested to be performed on the managed thing.</p> <note> <p>The field op can have a value of "I" or "U". The field "cn" will contain the capability types.</p> </note>
  - `OperationVersion` string — The Open Connectivity Foundation (OCF) security specification version for the operation being requested on the managed thing. For more information, see <a href="https://openconnectivity.org/specs/OCF_Security_Specification_v1.0.0.pdf">OCF Security Specification</a>.
  - `StatusCode` integer — The status code of the Open Connectivity Foundation (OCF) operation being performed on the managed thing.
  - `Message` string, password — <p>The device state change event payload.</p> <p>This parameter will include the following three fields:</p> <ul> <li> <p> <code>uri</code>: <code>schema auc://&lt;PARTNER-DEVICE-ID&gt;/ResourcePath</code> (The <code>Resourcepath</code> corresponds to an OCF resource.)</p> </li> <li> <p> <code>op</code>: For device state changes, this field must populate as <code>n+d</code>.</p> </li> <li> <p> <code>cn</code>: The content depends on the OCF resource referenced in <code>ResourcePath</code>.</p> </li> </ul>
  - `DeviceDiscoveryId` string — The id for the device discovery job.
  - `ConnectorDeviceId` string, password — <p>The third-party device id as defined by the connector. This device id must not contain personal identifiable information (PII).</p> <note> <p>This parameter is used for cloud-to-cloud devices only.</p> </note>
  - `TraceId` string — The trace request identifier. This is generated by IoT managed integrations and can be used to trace this command and its related operations in CloudWatch.
  - `Devices` Device[] — The list of devices.
    - `ConnectorDeviceId` string, password, required — <p>The device id as defined by the connector.</p> <note> <p>This parameter is used for cloud-to-cloud devices only.</p> </note>
    - `ConnectorDeviceName` string — The name of the device as defined by the connector.
    - `CapabilityReport` object, required — The capability report for the device.
      - `version` string, required — The version of the capability report.
      - `nodeId` string — The numeric identifier of the node.
      - `endpoints` MatterCapabilityReportEndpoint[], required — The endpoints used in the capability report.
        - `id` string, required — The id of the Amazon Web Services Matter capability report endpoint.
        - `deviceTypes` DeviceType[], required — The type of device.
        - `clusters` MatterCapabilityReportCluster[], required — Matter clusters used in capability report.
          - `id` string, required — The id of the Amazon Web Services Matter capability report cluster.
          - `revision` integer, required — The id of the revision for the Amazon Web Services Matter capability report.
          - `publicId` string — The id of the schema version.
          - `name` string — The capability name used in the Amazon Web Services Matter capability report.
          - `specVersion` string — The spec version used in the Amazon Web Services Matter capability report.
          - `attributes` MatterCapabilityReportAttribute[] — The attributes of the Amazon Web Services Matter capability report.
            - `id` string — The id of the Matter attribute.
            - `name` string — Name for the Amazon Web Services Matter capability report attribute.
            - `value` object — Value for the Amazon Web Services Matter capability report attribute.
          - `commands` MatterCommandId[] — The commands used with the Amazon Web Services Matter capability report.
          - `events` MatterEventId[] — The events used with the Amazon Web Services Matter capability report.
          - `featureMap` integer — 32 bit-map used to indicate which features a cluster supports.
          - `generatedCommands` MatterCommandId[] — Matter clusters used in capability report.
          - `fabricIndex` integer — The fabric index for the Amazon Web Services Matter capability report.
        - `parts` EndpointId[] — Heirachy of child endpoints contained in the given endpoint.
        - `semanticTags` EndpointSemanticTag[] — Semantic information related to endpoint.
        - `clientClusters` ClusterId[] — Semantic information related to endpoint.
    - `CapabilitySchemas` CapabilitySchemaItem[] — Report of all capabilities supported by the device.
      - `Format` 'AWS' | 'ZCL' | 'CONNECTOR', required — The format of the capability schema, which defines how the schema is structured and interpreted.
      - `CapabilityId` string, required — The unique identifier of the capability defined in the schema.
      - `ExtrinsicId` string, required — The external identifier for the capability, used when referencing the capability outside of the AWS ecosystem.
      - `ExtrinsicVersion` integer, required — The version of the external capability definition, used to track compatibility with external systems.
      - `Schema` object, required — The actual schema definition that describes the capability's properties, actions, and events.
    - `DeviceMetadata` object — The metadata attributes for a device.
  - `MatterEndpoint` object — Structure describing a managed thing.
    - `id` string — The Matter endpoint id.
    - `clusters` MatterCluster[] — A list of Matter clusters for a managed thing.
      - `id` string — The cluster id.
      - `attributes` object — The Matter attributes.
      - `commands` object — Describe the Matter commands with the Matter command identifier mapped to the command fields.
      - `events` object — Describe the Matter events with the Matter event identifier mapped to the event fields.

## Response `202`

Success

- SendConnectorEventResponse
  - `ConnectorId` string, required — The id of the connector between the third-party cloud provider and IoT managed integrations.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — ServiceUnavailableException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iot-managed-integrations.md) · [All operations](https://skmtc.net/aws/apis/iot-managed-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot-managed-integrations/versions/d043c13c812a/schema)