> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Adtraction

The Adtraction connector lets your AI agent act in each user's Adtraction account. Each user connects their own Adtraction API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 33 tools.

**Authentication:** API Key
**Categories:** Marketing, Analytics
**Tools:** 33: 31 read, 2 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ADTRACTION)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Adtraction connection

   In **AgentKit > Connections**, create an Adtraction connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'adtraction'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Adtraction:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'adtraction_applications_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "adtraction"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Adtraction:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="adtraction_applications_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Adtraction credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'adtraction_applications_list',
  toolInput: {},
  connector: 'adtraction',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="adtraction_applications_list",
    tool_input={},
    connection_name="adtraction",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `adtraction_applications_list`

List Applications · Read-only

List the status of your channels' applications to Adtraction partner programs.
Returns each application's program, channel and approval status.
Filter by program or channel ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{}`

### `adtraction_balance_get`

Get Account Balance · Read-only

Get your Adtraction account balance in one currency.
Returns the accumulated commission balance.
Use List Payments for paid-out amounts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.

Example input: `{"currency":"<currency>"}`

### `adtraction_channels_list`

List Channels · Read-only

List the approved channels (websites, newsletters, social accounts) in your Adtraction partner account.
Returns each channel's id, name, type and URL.
Use a channel ID in tracking links, feeds and statistics.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `adtraction_clicks_list`

List Clicks · Read-only

List the clicks tracked in your Adtraction account for a period.
Returns each click with time, program, channel, EPI values and commission.
Filter by program, channel, market, EPI or click IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `commission_only` (`boolean`, optional): If set to true, only clicks with commission will be returned. Example: false.
- `epi` (`string`, optional): EPI value (your own tracking parameter in the tracking link). Example: newsletter-jan.
- `epi2` (`string`, optional): EPI2 value (second tracking parameter). Example: banner-top.
- `epi3` (`string`, optional): EPI3 value (third tracking parameter). Example: campaign-a.
- `epi4` (`string`, optional): EPI4 value (fourth tracking parameter). Example: variant-b.
- `epi5` (`string`, optional): EPI5 value (fifth tracking parameter). Example: user-42.
- `gbraid` (`string`, optional): Only clicks with this gbraid value. Example: gbraid123.
- `gclid` (`string`, optional): Only clicks with this Google Click ID. Example: Cj0KCQiA1234.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `wbraid` (`string`, optional): Only clicks with this wbraid value. Example: wbraid123.

Example input: `{"currency":"<currency>","from_date":"<from_date>","to_date":"<to_date>"}`

### `adtraction_commission_by_payment_status_get`

Get Commission By Payment Status · Read-only

Get the commission you earned in Adtraction over a period, grouped by payment status.
Returns totals for not invoiced, invoiced, ready for payment and paid.
Requires from_date, to_date and currency.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","to_date":"<to_date>"}`

### `adtraction_commission_by_transaction_status_get`

Get Commission By Transaction Status · Read-only

Get the commission you earned in Adtraction over a period, grouped by transaction status.
Returns totals for approved, pending and rejected transactions.
Requires from_date, to_date and currency.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","to_date":"<to_date>"}`

### `adtraction_commission_by_type_get`

Get Commission By Type · Read-only

Get the commission you earned in Adtraction over a period, grouped by commission type.
Returns commission totals per type.
Requires from_date, to_date, currency and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_currencies_list`

List Currencies · Read-only

List the currencies active on the Adtraction platform.
Returns ISO 4217 currency codes.
Use one in statistics, balance and payment tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `adtraction_markets_list`

List Markets · Read-only

List the geographical markets where Adtraction runs partner programs.
Returns each market's id, name and country code.
Use a market ID with the program category, directory and new-program tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `adtraction_offers_list`

List Coupons And Offers · Read-only

List coupon codes, vouchers and offers from Adtraction partner programs.
Returns each offer's program, code, description and validity.
Filter by market, program or channel.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{}`

### `adtraction_payment_transactions_list`

List Payment Transactions · Read-only

List the transactions included in one Adtraction payment.
Returns the transactions with order value and commission.
Use List Payments to find the payment ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `payment_id` (`integer`, required): Numerical ID of a payment, from List Payments. Example: 845521.

Example input: `{"payment_id":845521}`

### `adtraction_payments_list`

List Payments · Read-only

List the payments Adtraction has generated to your account in one currency.
Returns each payment's id, date, amount and status.
Use List Payment Transactions for a payment's contents.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.

Example input: `{"currency":"<currency>"}`

### `adtraction_product_feed_get`

Get Product Feed · Read-only

Get all products in an advertiser's product feed for one of your channels, with tracking links.
Returns each product's name, price, URLs, tracking URL, image, stock and attributes.
Use Get Product Feed Info for feed IDs and sizes first.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `channel_id` (`integer`, required): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, required): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `feed_id` (`integer`, optional): Numerical ID of a product feed. Example: 5521.
- `gt` (`boolean`, optional): Set true to make tracking links comply with Google Ads' Transparent Click Tracker rules. Example: false.
- `set_epi` (`boolean`, optional): If set to true, the epi will be set to the product name in tracking urls. Example: false.

Example input: `{"channel_id":1324738001,"program_id":1229865361}`

### `adtraction_product_feed_info_get`

Get Product Feed Info · Read-only

Get information about an advertiser's product feeds for one of your channels.
Returns each feed's id, name, product count, last update and download URL.
Use Get Product Feed to fetch the products.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `channel_id` (`integer`, required): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, required): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"channel_id":1324738001,"program_id":1229865361}`

### `adtraction_products_search`

Search Products · Read-only

Search the Adtraction product database by keyword, with program, market, currency, stock and price filters.
Returns a page of products with name, price, URLs, image, stock and program.
Use Get Tracking Link to turn a product URL into a tracking link.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `keyword` (`string`, required): Search keyword. Supports AND, OR, -term, "phrases", trailing * wildcards, field:value (e.g. sku:1334868914) and AND discounted:true. Example: Nivea AND shower.
- `page` (`integer`, required): Page number, starting at 0. Example: 0.
- `page_size` (`integer`, required): Products per page. Example: 10.
- `currency` (`string`, optional): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `in_stock` (`boolean`, optional): Only return products that are (or are not) in stock. Example: true.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `max_price` (`number`, optional): Only show products with a price of at most maxPrice. Example: 500.
- `min_price` (`number`, optional): Only show products with a price of at least minPrice. Example: 10.
- `program_id` (`string`, optional): One or more program IDs, comma-separated. Example: 1229865361.
- `sort` (`string`, optional): Determines the sort order. The value of this parameter is a comma-separated list of sort keys. Sort directions 'asc' or 'desc' can optionally be appended to each sort key, separated by the ':' character. Available keys are: productPrice, programId, inStock, manufacturerArticleNumber, ean. Example: productPrice:asc.

Example input: `{"keyword":"<keyword>","page":0,"page_size":10}`

### `adtraction_program_categories_list`

List Program Categories · Read-only

List the program categories on an Adtraction market, such as Banking & Finance.
Returns each category with the number of programs in it.
Use List Markets for the market ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `market_id` (`integer`, required): Numerical ID of a geographical market, from List Markets. Example: 1.

Example input: `{"market_id":1}`

### `adtraction_program_commissions_list`

List Commission Types · Read-only

List the commission types a partner program offers in its standard segment, such as a sale or a lead.
Returns each commission's id, name, type, value and category or threshold levels.
Use a commission ID with Create Claim.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `program_id` (`integer`, required): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"program_id":1229865361}`

### `adtraction_program_directory_get`

Get Program Directory · Read-only

List all Adtraction partner programs on a market with their categories.
Returns programs grouped with their category.
Use Get Programs for one program's full terms.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `market_id` (`integer`, required): Numerical ID of a geographical market, from List Markets. Example: 1.

Example input: `{"market_id":1}`

### `adtraction_programs_get`

Get Programs · Read-only

Get Adtraction partner programs on a market, with their rules, commissions, feeds and tracking URL.
Returns each program's id, name, category, currency, commissions, marketing rules, EPC and, with a channel, approval status and tracking URL.
Filter by program, channel, approval status or program status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `approval_status` (`integer`, optional): Only programs where the channel's application has this status: 0 = rejected, 1 = approved, 2 = pending review. Needs channel_id. Example: 1. One of: `0`, `1`, `2`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `status` (`integer`, optional): Only programs with this platform status: 0 = live, 3 = closing. Example: 0. One of: `0`, `3`.

Example input: `{"market":"<market>"}`

### `adtraction_programs_new_list`

List New Programs · Read-only

List partner programs added to an Adtraction market recently (usually the last 30 days).
Returns the new programs with id and name.
Use Get Programs for their terms.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `market_id` (`integer`, required): Numerical ID of a geographical market, from List Markets. Example: 1.

Example input: `{"market_id":1}`

### `adtraction_statistics_by_ad_get`

Get Statistics By Ad · Read-only

Get your Adtraction traffic and earnings statistics grouped by ad for a period.
Returns impressions, clicks, transactions, conversion and commission grouped by ad.
Requires from_date, to_date, currency, market and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","market":"<market>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_statistics_by_channel_get`

Get Statistics By Channel · Read-only

Get your Adtraction traffic and earnings statistics grouped by channel for a period.
Returns impressions, clicks, transactions, conversion and commission grouped by channel.
Requires from_date, to_date, currency, market and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","market":"<market>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_statistics_by_day_get`

Get Statistics By Day · Read-only

Get your Adtraction traffic and earnings statistics grouped by day for a period.
Returns impressions, clicks, transactions, conversion and commission grouped by day.
Requires from_date, to_date, currency, market and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","market":"<market>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_statistics_by_epi_get`

Get Statistics By EPI · Read-only

Get your Adtraction traffic and earnings statistics grouped by EPI values for a period.
Returns impressions, clicks, transactions, conversion and commission grouped by EPI values.
Requires from_date, to_date, currency, market and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `groupby_epi` (`boolean`, optional): Determines whether the output should be grouped by the EPI attribute. Defaults to true. Example: true.
- `groupby_epi2` (`boolean`, optional): Determines whether the output should be grouped by the EPI2 attribute. Defaults to false. Example: true.
- `groupby_epi3` (`boolean`, optional): Determines whether the output should be grouped by the EPI3 attribute. Defaults to false. Example: true.
- `groupby_epi4` (`boolean`, optional): Determines whether the output should be grouped by the EPI4 attribute. Defaults to false. Example: true.
- `groupby_epi5` (`boolean`, optional): Determines whether the output should be grouped by the EPI5 attribute. Defaults to false. Example: true.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","market":"<market>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_statistics_by_program_get`

Get Statistics By Program · Read-only

Get your Adtraction traffic and earnings statistics grouped by program for a period.
Returns impressions, clicks, transactions, conversion and commission grouped by program.
Requires from_date, to_date, currency, market and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","market":"<market>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_statistics_get`

Get Statistics · Read-only

Get your Adtraction traffic and earnings statistics for a period.
Returns impressions, clicks, transactions, conversion and commission.
Requires from_date, to_date, currency, market and transaction_status.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `market` (`string`, required): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"currency":"<currency>","from_date":"<from_date>","market":"<market>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_tracking_errors_list`

List Tracking Errors · Read-only

List tracking errors in your Adtraction account from the last seven days.
Returns each error with program, channel, type and time.
Older errors are deleted automatically.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{}`

### `adtraction_tracking_link_get`

Get Tracking Link · Read-only

Create an Adtraction tracking link for a program and channel, optionally to a specific page and with EPI values.
Returns the tracking URL, or a short link.
The target URL must be on the advertiser's domain.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `channel_id` (`integer`, required): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, required): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `epi` (`string`, optional): EPI value (your own tracking parameter in the tracking link). Example: newsletter-jan.
- `epi2` (`string`, optional): EPI2 value (second tracking parameter). Example: banner-top.
- `epi3` (`string`, optional): EPI3 value (third tracking parameter). Example: campaign-a.
- `epi4` (`string`, optional): EPI4 value (fourth tracking parameter). Example: variant-b.
- `epi5` (`string`, optional): EPI5 value (fifth tracking parameter). Example: user-42.
- `short_link` (`boolean`, optional): If set to true, the output will be a short link instead of a traditional tracking link. Example: false.
- `url` (`string`, optional): URL to the web page you want to link to. Must include protocol ("http:" or "https:") and be located on the advertiser's domain. Example: https://www.advertiser.example/products/123.

Example input: `{"channel_id":1324738001,"program_id":1229865361}`

### `adtraction_transactions_gclid_list`

List Transactions With Gclid · Read-only

List Adtraction transactions that carry a Google Click ID (gclid) for a period.
Returns the transactions with their gclid, order value and commission.
Use it to import conversions into Google Ads.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Impressions and clicks are not affected. Example: 3. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.

Example input: `{"from_date":"<from_date>","to_date":"<to_date>","transaction_status":3}`

### `adtraction_transactions_latest_list`

List Latest Transactions · Read-only

List your most recent approved or pending Adtraction transactions.
Returns the latest transactions, 10 by default.
Use List Transactions for a date range and filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `number` (`integer`, required): How many transactions to return. Example: 10.

Example input: `{"number":10}`

### `adtraction_transactions_list`

List Transactions · Read-only

List the transactions (sales and leads) tracked in your Adtraction account for a period.
Returns each transaction with order value, commission, status, payment status, program, channel and EPI.
Use List Latest Transactions for a quick recent view.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `from_date` (`string`, required): Start of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-01T00:00:00+0000. Example: 2026-01-01T00:00:00+0000.
- `to_date` (`string`, required): End of the period, as an ISO 8601 UTC timestamp, e.g. 2026-01-31T23:59:59+0000. Example: 2026-01-31T23:59:59+0000.
- `transaction_status` (`integer`, required): Which transactions to include: 0 = all, 1 = approved, 2 = pending, 3 = approved + pending, 4 = open claims, 5 = rejected. Example: 0. One of: `0`, `1`, `2`, `3`, `4`, `5`.
- `channel_id` (`integer`, optional): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `currency` (`string`, optional): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `epi` (`string`, optional): EPI value (your own tracking parameter in the tracking link). Example: newsletter-jan.
- `last_updated` (`string`, optional): If used as input, the dataset will only include transactions that were updated after the specified time. Example: 2026-01-15T00:00:00+0000.
- `market` (`string`, optional): Market as an ISO 3166-1 alpha-2 country code, e.g. SE. Example: SE.
- `payment_status` (`integer`, optional): Only transactions with this payment status: 1 = not invoiced, 2 = invoiced to advertiser, 3 = ready for payment, 4 = paid to partner. Example: 4. One of: `1`, `2`, `3`, `4`.
- `program_id` (`integer`, optional): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `unique_id` (`string`, optional): Unique ID for the transaction. Example: TX-998812.

Example input: `{"from_date":"<from_date>","to_date":"<to_date>","transaction_status":0}`

### `adtraction_claim_create`

Create Claim · Write

Create a claim for a transaction Adtraction did not track.
Returns the created claim; the advertiser reviews it.
Get the commission ID from List Commission Types.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `channel_id` (`integer`, required): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `commission_id` (`integer`, required): Numerical ID of the commission. Example: 4411.
- `currency` (`string`, required): Currency as an ISO 4217 code, e.g. SEK or EUR. Example: SEK.
- `order_id` (`string`, required): Advertiser order ID. Example: ORD-55123.
- `order_value` (`number`, required): Order value of the transaction. Example: 455.
- `program_id` (`integer`, required): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `transaction_date` (`string`, required): UTC timestamp of when the transaction was reported by the advertiser. Example: 2026-01-14T12:30:00+0000.
- `epi` (`string`, optional): EPI value (your own tracking parameter in the tracking link). Example: newsletter-jan.
- `epi2` (`string`, optional): EPI2 value (second tracking parameter). Example: banner-top.
- `epi3` (`string`, optional): EPI3 value (third tracking parameter). Example: campaign-a.
- `epi4` (`string`, optional): EPI4 value (fourth tracking parameter). Example: variant-b.
- `epi5` (`string`, optional): EPI5 value (fifth tracking parameter). Example: user-42.
- `expected_commission` (`number`, optional): The expected commission amount for the claim. Should be used if the advertiser pays different commission for different product categories, meaning that a claim can consist of products from multiple categories, where each category gives the right to different commission. Example: 45.5.

Example input: `{"channel_id":1324738001,"commission_id":4411,"currency":"<currency>","order_id":"<order_id>","order_value":455,"program_id":1229865361,"transaction_date":"<transaction_date>"}`

### `adtraction_exclusive_coupon_get`

Get Exclusive Coupon · Write

Get one exclusive coupon code an advertiser assigned to your channel.
Returns the coupon code for the unique ID you give.
Use a new unique ID for each code you hand out.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `channel_id` (`integer`, required): Numerical ID of one of your channels (website, newsletter, social account), from List Channels. Example: 1324738001.
- `program_id` (`integer`, required): Numerical ID of an Adtraction partner program (advertiser), from Get Programs or List Applications. Example: 1229865361.
- `unique_id` (`string`, required): Your own unique ID for this code, e.g. a visitor or order reference; each ID gets its own code. Example: visitor-8842.

Example input: `{"channel_id":1324738001,"program_id":1229865361,"unique_id":"<unique_id>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
