Kadam icon

Kadam

Interact with Kadam API (v1.4.x) for managing campaigns, clients, creatives, and more.

Actions24

Creative → Update

AI-generated

Overview

This node interacts with the Kadam advertising platform API to update an existing ad creative. It allows users to modify properties such as the creative's status (active or paused), target URL, and country-specific bidding targets. This operation is useful for advertisers who want to adjust their ad creatives dynamically without recreating them, for example, to pause a campaign temporarily, update the landing page URL, or fine-tune bids for different countries.

Practical examples:

  • Pausing a creative during off-hours or when budget limits are reached.
  • Changing the destination URL of an ad creative after a promotion ends.
  • Adjusting bids for specific countries to optimize ad spend based on performance data.

Properties

Name Meaning
Retry on Failure Boolean option to retry the request up to 3 times on temporary failures like rate limits or network issues.
Creative ID Dropdown list to select which creative to update.
Status Status of the creative: "Paused" (0) or "Active" (1).
Target URL Optional new URL for the creative's landing page.
Country Targeting Optional collection to update targeting for specific countries with individual bid amounts. Each entry includes:
- Country: Select from available countries.
- Bid: Numeric bid amount for that country (minimum 0.0001).

Output

The node outputs JSON data representing the updated creative or the response from the Kadam API after the update operation. The output structure typically includes fields reflecting the creative's current state post-update, such as its ID, title, status, link URL, and any updated targeting bids.

If multiple items are processed, each output item corresponds to one input item with paired indexing.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Kadam API.
  • The node uses the Kadam API base URL https://api.kadam.net.
  • The API token and application ID must be configured in the node credentials.
  • The node depends on Axios for HTTP requests.
  • The node expects the Kadam API version v1.4.x or compatible.

Troubleshooting

  • Common Issues:

    • Invalid or expired API token causing authentication failures.
    • Selecting a non-existent creative ID will result in an error.
    • Providing invalid bid values (e.g., negative numbers or zero) may cause API rejection.
    • Network issues or rate limiting can cause temporary failures; enabling "Retry on Failure" helps mitigate these.

  • Error Messages:

    • "Unsupported resource": Occurs if the resource parameter is not set to "creative".
    • API errors returned from Kadam include descriptive messages; these are wrapped and surfaced by the node.
    • If the node returns no data but completes successfully, it indicates the update was accepted but no content was returned.

  • Resolution Tips:

    • Verify API credentials and permissions.
    • Ensure the creative ID exists and belongs to the authenticated account.
    • Use valid numeric bids greater than zero.
    • Enable retry on failure for transient network or rate limit errors.

Links and References

Discussion