Actions24
- Campaign Actions
- Creative Actions
- Stats Actions
- Targeting Actions
Creative → Create
AI-generatedOverview
This node integrates with the Kadam advertising platform API to manage ad creatives within campaigns. Specifically, the Creative - Create operation allows users to create new ad creatives (advertisements) associated with a campaign. This is useful for marketers and advertisers who want to programmatically add new ads with specific formats, media, targeting, and other settings directly from their n8n workflows.
Common scenarios include:
- Automating the creation of multiple ad creatives for different campaigns.
- Dynamically generating creatives based on external data or triggers.
- Managing ad content updates without manual intervention in the Kadam dashboard.
Example: Creating a push notification ad creative with a headline, description text, target URL, and associated media assets, optionally pausing it after moderation.
Properties
| Name | Meaning |
|---|---|
| Campaign ID | The ID of the campaign to which the creative will be added. Must be selected from existing campaigns. |
| Retry on Failure | Whether to retry the request up to 3 times on temporary failures such as rate limits or network issues. |
| Title | The headline or title of the creative. |
| Ad Format | The format type of the ad creative (e.g., banner, teaser, push notification). Options are loaded dynamically from the Kadam API. |
| Text | Description text for the creative. Required for push notifications but not used for teasers. |
| Target URL | The URL that the ad points to, e.g., the landing page of the advertised product or service. |
| Media ID | The ID of the previously uploaded media asset to use in the creative. This must be uploaded beforehand using the "Upload Media" operation. |
| Rectangular Media ID | The ID of a rectangular media asset, required for push notifications and teasers. |
| Pause After Moderation | If set to true, the creative will be automatically paused after it goes through moderation. |
| Banner Size | The size of the banner, applicable only if the ad format is a banner. Options are loaded dynamically from the Kadam API. |
| Country Targeting | Optional collection of country-specific bids. Allows targeting specific countries with custom bid amounts. If not specified, the campaign's default bids are used. Each entry includes: - Country: The country to target. - Bid: The bid amount for that country. |
Output
The node outputs JSON data representing the created creative(s). The structure typically includes fields returned by the Kadam API such as creative ID, title, status, and other metadata about the newly created ad creative.
If the operation returns multiple creatives, each is output as a separate item.
No binary data output is indicated for this operation.
Dependencies
- Requires an active Kadam API credential configured in n8n, including an API token and application ID.
- Uses the Kadam REST API endpoints for managing creatives.
- Network connectivity to
https://api.kadam.netis required.
Troubleshooting
- API Authentication Errors: Ensure the API token and app ID credentials are correctly configured and valid.
- Invalid Campaign or Media IDs: The campaign ID and media IDs must exist and be accessible; otherwise, the API will return errors.
- Missing Required Fields: Title, Ad Format, Target URL, and Media ID are mandatory. Omitting these will cause validation errors.
- Rate Limits / Temporary Failures: Enable "Retry on Failure" to automatically retry requests up to 3 times on transient errors like rate limiting.
- Banner Size Requirement: When using the banner ad format, specifying the banner size is mandatory; failure to do so may result in errors.
- Country Targeting Bids: If providing country bids, ensure all required fields (country and bid) are properly set and valid numbers.
Error messages from the API are wrapped and surfaced with details when possible, aiding diagnosis.
Links and References
- Kadam API Documentation (official API docs, for detailed endpoint info)
- Kadam platform user guides (for campaign and creative management concepts)
This summary is based solely on static analysis of the provided source code and property definitions. It does not execute or simulate runtime behavior.