Webhook smart module allows calls to your server to handle events and commands.

Endpoints

Send command to external server

Endpoint
put /homes/{homeId}/smartModules/{moduleId}/command
Description

Accept a command object and relay it to an external server. The specified Smart Module must have a command webhook defined in its configuration.

Authorization Headers What's this?

Must contain a user or project API key.

URI Parameters
  • homeId

    integer

    required

    The unique id for a home.

  • moduleId

    string

    required

    The unique id for a smart module.

Response
  • 204Data have been sent successfully.
  • 401Authorization is required to access this resource.
  • 403Request failed because of invalid data or denied permission.
  • 404The requested command does not exist or is not accessible.
  • 500An unexpected error has occurred.
  • 503The service is temporarily unavailable.

Request Body Sample

{
    "action": "set-alarm-state",
    "parameters": {
        "rooms": [ "living-room", "master-bedroom" ],
        "armed": true
    }
}