Actions24
- Campaign Actions
- Creative Actions
- Stats Actions
- Targeting Actions
Campaign → Create
AI-generatedOverview
This node integrates with the Kadam advertising platform API to create new advertising campaigns. It allows users to define detailed campaign parameters such as campaign name, ad format, pricing model, target URL, geographic targeting with bids, categories, and additional options like budget limits and device/language targeting.
Typical use cases include:
- Launching new ad campaigns programmatically within an automated workflow.
- Setting up campaigns with precise targeting and bidding strategies across multiple countries.
- Managing campaign budgets and limits dynamically based on business rules.
- Integrating campaign creation into larger marketing automation or reporting pipelines.
For example, a user can create a campaign targeting specific countries with custom bids, select an ad format (e.g., banner or teaser), choose CPC or CPM pricing, and specify daily or total budget caps — all from within n8n without manual intervention in the Kadam dashboard.
Properties
| Name | Meaning |
|---|---|
| Campaign Name | The name of the new campaign. |
| Ad Format | Select the ad format for the campaign. Options are dynamically loaded from Kadam (e.g., banner, teaser). |
| Price Model | The pricing model for the campaign. Options: "CPC (Cost Per Click)" or "CPM (Cost Per Mille)". |
| Target URL | The destination URL where the ads will redirect users. Example: https://example.com/landing?param=value. |
| Status | Optional status of the campaign. Options: "(No Change / Default)", "Active", or "Paused". |
| Country Targeting | A collection of one or more country targets, each specifying: - Country: The country to target (dynamically loaded list). - Bid: The bid amount for that country (minimum 0.0001). |
| Categories | One or more relevant campaign categories selected from a dynamically loaded list. Required. |
| Additional Options | Collection of optional settings including: - Daily Budget Limit (max daily spend, 0 = unlimited) - Total Budget Limit (max total spend, 0 = unlimited) - Total Clicks Limit (0 = unlimited) - Languages (target browser languages) - Devices (target device types) |
| Retry on Failure | Boolean flag to retry the request up to 3 times on temporary failures such as rate limits or network issues. |
Output
The node outputs JSON data representing the created campaign(s) as returned by the Kadam API. The structure typically includes campaign identifiers, status, configuration details, and any metadata provided by the API response.
- Each output item corresponds to one created campaign.
- The output is paired with the input item index for traceability.
- No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Kadam API.
- The node uses the Kadam REST API endpoints under
https://api.kadam.net. - Dynamic option loading depends on successful API calls to retrieve ad formats, countries, categories, languages, and devices.
- Network connectivity to Kadam API must be available.
Troubleshooting
- API Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
- Invalid or Missing Required Fields: The node requires mandatory fields like campaign name, ad format, price model, target URL, country targeting, and categories. Missing these will cause errors.
- Country Targeting Bids: Bids must be numeric and at least 0.0001; invalid values may cause API rejection.
- Rate Limits or Temporary Failures: Enable "Retry on Failure" to automatically retry up to 3 times on transient errors.
- Unexpected API Response Structure: If the Kadam API changes, the node might fail to parse responses correctly. Check logs for detailed error messages.
- Network Issues: Verify network access to
api.kadam.net.
Common error messages include:
"Unsupported resource"if the resource parameter is incorrect."Failed to load campaign categories"if category options cannot be retrieved.- API error messages returned from Kadam are included in the output for diagnosis.
Links and References
- Kadam API Documentation (official API docs, if publicly available)
- Kadam platform website (for account and API key management)
Note: This summary is based solely on static analysis of the provided source code and property definitions. Runtime behavior depends on actual API responses and environment setup.