STEM Connect icon

STEM Connect

Manage telecommunications operations with STEM Connect API

Actions30

Device → Get Promo Products

AI-generated

Overview

This node integrates with the STEM Connect API to manage telecommunications operations. Specifically, for the Device resource and the Get Promo Products operation, it retrieves promotional products related to network devices from the STEM Connect system.

This node is beneficial in scenarios where telecom operators or service providers want to automate fetching promotional device-related product offers directly within their workflows. For example, a user might use this node to dynamically retrieve current promotional products to display on a customer portal or to trigger marketing campaigns based on available promotions.

Properties

Name Meaning
Subsystem Selects which subsystem of the STEM Connect API to interact with. Options are:
- Main: Main application API endpoints
- Portal: Portal subsystem API endpoints
- API: Direct API subsystem endpoints

Output

  • The output is an array of JSON objects representing promotional products retrieved from the STEM Connect API.
  • Each item corresponds to a promotional product related to devices.
  • The exact structure of each promotional product object depends on the STEM Connect API response but typically includes details such as product identifiers, descriptions, pricing, and promotion specifics.
  • No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the STEM Connect API.
  • The node uses the stemConnectApiRequest helper function to make HTTP requests to the STEM Connect endpoints.
  • Proper configuration of the API credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Authentication failures due to missing or invalid API credentials.
    • Network connectivity issues preventing access to the STEM Connect API.
    • Unexpected API responses if the subsystem or resource parameters are incorrectly set.

  • Error Messages:

    • Errors returned from the API will be captured and can appear in the output under an error field if "Continue On Fail" is enabled.
    • Typical error messages include authentication errors, invalid parameter errors, or server-side errors from the STEM Connect API.

  • Resolutions:

    • Verify that the API key credential is correctly configured and has sufficient permissions.
    • Ensure the selected subsystem matches the intended API endpoint.
    • Check network connectivity and firewall settings.
    • Review the STEM Connect API documentation for correct usage of parameters.

Links and References

Discussion