Webbing icon

Webbing

Consume Webbing API (v.0.1.3)
Join our community

Actions2

Overview

The Webbing node for n8n allows you to interact with the Webbing API, specifically to manage devices. The "Activate" operation under the "Devices" resource is used to activate a service device by providing identifiers such as Service Device ID, IMEI, SSID, ICCID, or EID. This node is beneficial in automation scenarios where you need to programmatically activate devices in bulk or as part of a workflow, such as onboarding new IoT devices or managing SIM activations.

Example use cases:

  • Automatically activating a batch of new devices after provisioning.
  • Integrating device activation into customer onboarding workflows.
  • Triggering device activation based on external events (e.g., order fulfillment).

Properties

Name Type Meaning
Service Device Identifier Collection A group of identifiers used to specify the device to be activated.
└─ Service Device ID String Unique identifier for the service device.
└─ IMEI String International Mobile Equipment Identity number of the device.
└─ SSID String Service Set Identifier, possibly used for Wi-Fi enabled devices.
└─ ICCID String Integrated Circuit Card Identifier, typically for SIM cards.
└─ EID String Embedded Identity Document, used for eSIM-enabled devices.
Simplify Output Boolean Whether to simplify the output data structure returned by the node.

Output

  • The node outputs a json object containing the response from the Webbing API regarding the activation request.
  • If "Simplify Output" is enabled, the output will be a simplified version of the API response, making it easier to use in subsequent nodes.
  • The exact structure of the output depends on the Webbing API's response for the activation endpoint, but typically includes status information and details about the activated device.
  • Binary Data: This node does not output binary data; all responses are in JSON format.

Dependencies

  • External Service: Requires access to the Webbing API.
  • API Credentials: You must configure valid Webbing API credentials in n8n under the name webbingApi.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the provided API credentials are incorrect or missing, the node will fail to authenticate with the Webbing API.
  • Missing Required Identifiers: If none of the device identifiers (Service Device ID, IMEI, etc.) are provided, the activation may fail due to insufficient information.
  • API Errors: Any errors returned by the Webbing API (such as invalid device ID, already activated device, or network issues) will be passed through in the node's output.

Error Messages and Resolutions:

  • "Authentication failed": Check your Webbing API credentials in n8n.
  • "Device not found": Verify that the provided identifiers match an existing device in Webbing.
  • "Activation failed": Ensure the device is eligible for activation and that all required fields are correctly filled.

Links and References

Discussion