KadamInstall

Overview

This node integrates with the Kadam advertising platform API, enabling users to manage and retrieve data related to campaigns, creatives, targeting, stats, and clients. Specifically, for the Creative resource and the Get Banner Sizes operation, the node fetches available banner dimensions that can be used when creating or updating ad creatives.

Typical use cases include:

• Automatically retrieving valid banner sizes to ensure creatives conform to supported dimensions.
• Dynamically populating UI elements or workflows with banner size options for creative creation.
• Validating or filtering creatives based on supported banner sizes before uploading or publishing ads.

Example: A marketing automation workflow could use this node to fetch all banner sizes, then loop through them to create multiple creatives tailored to each size.

Properties

Output

The output is a JSON array containing objects representing banner sizes. Each object typically includes details such as the width and height of the banner dimension. The exact fields depend on the API response but generally describe the available banner dimensions for creatives.

No binary data output is involved in this operation.

Example output snippet (conceptual):

[
  {
    "id": "1",
    "title": "300x250",
    "width": 300,
    "height": 250
  },
  {
    "id": "2",
    "title": "728x90",
    "width": 728,
    "height": 90
  }
]

Dependencies

• Requires an API key credential and app ID credential configured in n8n to authenticate requests to the Kadam API.
• Uses the Axios HTTP client internally to make REST API calls to https://api.kadam.net.
• The node depends on the Kadam API being accessible and the credentials having sufficient permissions to query creative banner sizes.

Troubleshooting

• Common Issues:

  • Invalid or missing API credentials will cause authentication errors.
  • Network connectivity problems may lead to request failures.
  • Rate limiting by the Kadam API can result in temporary errors; enabling "Retry on Failure" helps mitigate this.
  • Unexpected API response structure changes might cause parsing errors.

• Error Messages:

  • Errors from the API are wrapped and returned with details including HTTP status code and error description.
  • If the node encounters an unsupported resource or operation, it throws an explicit error indicating invalid selection.
  • When the API returns no data or null, the node outputs a success message with no data rather than failing.

• Resolutions:

  • Verify API credentials and permissions.
  • Enable "Retry on Failure" to handle transient errors.
  • Check network connectivity and proxy settings if applicable.
  • Review Kadam API documentation for any breaking changes or updates.

Links and References

• Kadam API Documentation (official API endpoint base URL)
• n8n Documentation on Creating Custom Nodes
• Axios HTTP Client: https://axios-http.com/

This summary focuses exclusively on the Creative resource's Get Banner Sizes operation as requested, based on static analysis of the provided source code and property definitions.