@kadam-net/n8n-nodes-kadam/README.md

Kadam node for n8n to manage campaigns, creatives, and more.

# n8n-nodes-kadam

[![NPM Version](https://img.shields.io/npm/v/@kadam-net/n8n-nodes-kadam?style=flat-square)](https://www.npmjs.com/package/@kadam-net/n8n-nodes-kadam)
[![NPM Downloads](https://img.shields.io/npm/dm/@kadam-net/n8n-nodes-kadam?style=flat-square)](https://www.npmjs.com/package/@kadam-net/n8n-nodes-kadam)
[![Community Node](https://img.shields.io/badge/Community%20Node-EXECUTABLE-orange?style=flat-square)](https://github.com/n8n-io/n8n-community-nodes)

This is an n8n community node. It allows you to use the Kadam API within your n8n workflows.

[Kadam](https://kadam.net/) is an advertising platform. This node helps you manage resources like campaigns, creatives, and retrieve statistics.

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

Search for `@kadam-net/n8n-nodes-kadam` in the community nodes section.

## Operations

The node supports the following Kadam API resources and operations:

*   **Campaigns:** Create, Delete, Get, Update, Get Ad Formats, Get Categories, Update Placement Multiplier
*   **Creatives:** Create, Delete, Get, Update, Get Banner Sizes, Upload Media
*   **Stats:** Get Campaign Stats, Get Creative Stats By Campaign IDs, Get Creative Stats By Creative IDs, Get Placement Stats
*   **Targeting:** Get Browsers, Get Countries, Get Devices, Get Geo Countries, Get Languages, Get Platforms, Get Server Time

## Credentials

You will need to configure Kadam API credentials in n8n to use this node.
To obtain your API credentials:

1. Log in to your Kadam admin panel or contact your account manager
2. Request an API Token and App ID (Client ID)
3. Use these credentials when setting up the node in n8n

## Configuration

### Credentials

- **API Token**: Your authentication token (required)
- **App ID (Client ID)**: Your application identifier (required) - this is used across all operations

### Node Configuration

1. Select the **Resource** you want to work with (Campaign, Creative, Stats, or Targeting)
2. Choose the **Operation** for the selected resource
3. Configure the required parameters for the selected operation
4. Connect the node to your workflow

## Example Usage

### Getting Campaign Statistics

1. Add the Kadam node to your workflow
2. Select **Stats** as the resource
3. Choose **Get Campaign Stats** as the operation
4. Select a campaign from the dropdown menu
5. Configure the date range
6. Run the workflow to retrieve the statistics

### Working with Creatives

1. Add the Kadam node to your workflow
2. Select **Creative** as the resource
3. Choose an operation (**Create**, **Get**, **Update**, or **Delete**)
4. When selecting creatives, use the convenient dropdown menu that filters by ad format
5. For creative creation or updates, fill in the required creative information
6. Run the workflow to manage your creatives

## Support

If you encounter any issues or have questions about this node, please:
- Check the [GitHub repository](https://github.com/kadam-official/n8n-nodes-kadam) for known issues
- Contact your Kadam account manager for API-specific questions
- Open an issue on GitHub for node-specific problems

## Resources

*   [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)


## Contributing

Contributions are welcome! Please follow standard GitHub practices (fork, branch, pull request).

## License

MIT License. See the [LICENSE](LICENSE) file for details.