---
canonical_url: "https://docs.composio.dev/toolkits/trackdesk"
markdown_url: "https://docs.composio.dev/toolkits/trackdesk.md"
product: "platform"
version: null
last_updated: null
---

# Trackdesk

Trackdesk is an affiliate tracking platform for managing partners, offers, conversions, commissions, billing, and performance reporting.

- **Category:** marketing
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `TRACKDESK`
- **Version:** 00000000_00

## Tools

### Build Tracking Link

**Slug:** `TRACKDESK_BUILD_TRACKING_LINK`

Generate a Trackdesk tracking URL for one affiliate traffic source and offer. This only constructs a URL; it does not record a click, create a conversion, or change offer configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `target` | object | Yes | Exactly one tracking target variant: direct, system_redirect, or google_certified_redirect. |
| `offer_id` | string | Yes | Offer UUID returned by List Offers. |
| `source_id` | string | Yes | Affiliate traffic-source UUID returned as source_id by List Affiliates. |
| `affiliate_params` | object | No | Optional affiliate sub-IDs to append to the generated tracking URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Affiliate

**Slug:** `TRACKDESK_GET_AFFILIATE`

Return detailed information for one affiliate identified by its Trackdesk account ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | Trackdesk account UUID of the affiliate, returned by List Affiliates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Daily Performance Report

**Slug:** `TRACKDESK_GET_DAILY_PERFORMANCE_REPORT`

Return Trackdesk performance rows, newest first, and aggregate totals for an inclusive date range. Use a bounded range because the response contains one row per day and is not paginated. filled_columns, not zero-valued metric fields, identifies the selected metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `columns` | array | No | Standard metrics to mark as filled. Use filled_columns in the response to determine which metrics contain selected data. |
| `to_date` | string | Yes | Last report date in YYYY-MM-DD format. |
| `timezone` | string | Yes | IANA timezone used to divide activity into days, such as UTC or America/New_York. |
| `from_date` | string | Yes | First report date in YYYY-MM-DD format. |
| `source_ids` | array | No | Affiliate traffic-source UUIDs to include. |
| `conversion_statuses` | array | No | Conversion statuses to include. |
| `conversion_type_ids` | array | No | Conversion type UUIDs to include. |
| `custom_column_codes` | array | No | Custom report column codes to include. |
| `client_metric_column_codes` | array | No | Client metric codes to include in each day. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Advertisers

**Slug:** `TRACKDESK_LIST_ADVERTISERS`

Return one filtered page of advertisers. Trackdesk represents advertisers as revenue origins in this API. Increase offset by limit when has_more is true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum advertisers to return in this page (1-500). |
| `offset` | integer | No | Number of matching advertisers to skip before this page. |
| `filters` | object | No | Optional advertiser filters; supplied fields are combined by Trackdesk. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Affiliates

**Slug:** `TRACKDESK_LIST_AFFILIATES`

Return one filtered page of affiliates, including Trackdesk account and traffic-source identifiers, status, tier, fraud signals, tags, and available billing or payment details. Increase offset by the previous limit only when pagination.has_more is true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum affiliates to return in this page (1-500). |
| `offset` | integer | No | Number of matching affiliates to skip before this page. |
| `filters` | object | No | Optional affiliate filters; supplied fields are combined by Trackdesk. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Affiliate Tiers

**Slug:** `TRACKDESK_LIST_AFFILIATE_TIERS`

Return all active affiliate tiers with their IDs, names, exact default payout rates, and default-tier flags.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Coupons

**Slug:** `TRACKDESK_LIST_COUPONS`

Return one filtered page of Trackdesk coupons and their advertiser, affiliate traffic-source, offer, code, and status associations. Increase offset by limit only when pagination.has_more is true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `codes` | array | No | Exact coupon codes to include. |
| `limit` | integer | No | Maximum coupons to return in this page (1-500). |
| `offset` | integer | No | Number of matching coupons to skip before this page. |
| `statuses` | array | No | Coupon statuses to include. |
| `offer_ids` | array | No | Offer UUIDs to include. |
| `source_ids` | array | No | Affiliate traffic-source UUIDs to include. |
| `advertiser_ids` | array | No | Advertiser UUIDs, called revenue origin IDs by the API, to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Offers

**Slug:** `TRACKDESK_LIST_OFFERS`

Return one filtered page of Trackdesk offers with each offer's data, pricing configuration, and landing pages. Increase offset by limit only when pagination.has_more is true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Partial case-insensitive offer name match. |
| `limit` | integer | No | Maximum offers to return in this page (1-500). |
| `offset` | integer | No | Number of matching offers to skip before this page. |
| `pinned` | boolean | No | True for pinned offers, false for unpinned offers, or omit to include both. |
| `tag_ids` | array | No | Return offers having at least one of these tag UUIDs. |
| `statuses` | array | No | Offer statuses to include. |
| `offer_ids` | array | No | Specific offer UUIDs to return. |
| `category_ids` | array | No | Offer category UUIDs to include. |
| `visibilities` | array | No | Offer visibility values to include. |
| `country_codes` | array | No | Return offers targeting any of these ISO 3166-1 alpha-2 country codes. |
| `conversion_type_ids` | array | No | Return offers priced for any of these conversion type UUIDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tags

**Slug:** `TRACKDESK_LIST_TAGS`

Return all Trackdesk tags with their IDs, names, colors, and resource scopes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |