> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# the-trade-desk

> Trade Desk Advertising

**Server path:** `/the-trade-desk` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                            | Description                                         |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [`the_trade_desk_create_ad_group`](#the_trade_desk_create_ad_group)                             | Create a new ad group                               |
| [`the_trade_desk_create_advertiser`](#the_trade_desk_create_advertiser)                         | Create a new advertiser                             |
| [`the_trade_desk_create_audience`](#the_trade_desk_create_audience)                             | Create a new audience segment                       |
| [`the_trade_desk_create_bid_list`](#the_trade_desk_create_bid_list)                             | Create a new bid list                               |
| [`the_trade_desk_create_campaign`](#the_trade_desk_create_campaign)                             | Create a new campaign                               |
| [`the_trade_desk_create_campaign_flight`](#the_trade_desk_create_campaign_flight)               | Create a campaign flight (budget allocation period) |
| [`the_trade_desk_create_creative`](#the_trade_desk_create_creative)                             | Create a new creative                               |
| [`the_trade_desk_delete_bid_list`](#the_trade_desk_delete_bid_list)                             | Delete a bid list                                   |
| [`the_trade_desk_get_ad_group`](#the_trade_desk_get_ad_group)                                   | Retrieve an ad group by ID                          |
| [`the_trade_desk_get_ad_group_status`](#the_trade_desk_get_ad_group_status)                     | Get the status of an ad group                       |
| [`the_trade_desk_get_advertiser`](#the_trade_desk_get_advertiser)                               | Retrieve an advertiser by ID                        |
| [`the_trade_desk_get_audience`](#the_trade_desk_get_audience)                                   | Retrieve an audience by ID                          |
| [`the_trade_desk_get_bid_list`](#the_trade_desk_get_bid_list)                                   | Retrieve a bid list by ID                           |
| [`the_trade_desk_get_campaign`](#the_trade_desk_get_campaign)                                   | Retrieve a campaign by ID                           |
| [`the_trade_desk_get_campaign_flight`](#the_trade_desk_get_campaign_flight)                     | Retrieve a campaign flight by ID                    |
| [`the_trade_desk_get_campaign_metrics`](#the_trade_desk_get_campaign_metrics)                   | Get performance metrics for a campaign              |
| [`the_trade_desk_get_creative`](#the_trade_desk_get_creative)                                   | Retrieve a creative by ID                           |
| [`the_trade_desk_query_ad_groups_by_campaign`](#the_trade_desk_query_ad_groups_by_campaign)     | Query ad groups by campaign ID                      |
| [`the_trade_desk_query_advertisers_by_partner`](#the_trade_desk_query_advertisers_by_partner)   | Query advertisers by partner ID                     |
| [`the_trade_desk_query_campaigns_by_advertiser`](#the_trade_desk_query_campaigns_by_advertiser) | Query campaigns by advertiser ID                    |
| [`the_trade_desk_query_creatives_by_advertiser`](#the_trade_desk_query_creatives_by_advertiser) | Query creatives by advertiser ID                    |
| [`the_trade_desk_update_ad_group`](#the_trade_desk_update_ad_group)                             | Update an existing ad group                         |
| [`the_trade_desk_update_advertiser`](#the_trade_desk_update_advertiser)                         | Update an existing advertiser                       |
| [`the_trade_desk_update_audience`](#the_trade_desk_update_audience)                             | Update an existing audience                         |
| [`the_trade_desk_update_bid_list`](#the_trade_desk_update_bid_list)                             | Update an existing bid list                         |
| [`the_trade_desk_update_campaign`](#the_trade_desk_update_campaign)                             | Update an existing campaign                         |
| [`the_trade_desk_update_campaign_flight`](#the_trade_desk_update_campaign_flight)               | Update a campaign flight                            |
| [`the_trade_desk_update_creative`](#the_trade_desk_update_creative)                             | Update an existing creative                         |

***

## the\_trade\_desk\_create\_ad\_group

Create a new ad group

**Parameters:**

| Parameter            | Type      | Required | Default | Description                                  |
| -------------------- | --------- | -------- | ------- | -------------------------------------------- |
| `AdGroupName`        | string    | Yes      | —       | Display name of the ad group                 |
| `AssociatedBidLists` | object\[] | No       | —       | Bid lists associated with this ad group      |
| `CampaignId`         | string    | Yes      | —       | ID of the campaign this ad group belongs to  |
| `CreativeIds`        | string\[] | No       | —       | Creative IDs to associate with this ad group |
| `Description`        | string    | No       | —       | Optional description                         |
| `IndustryCategoryId` | integer   | No       | —       | Industry category ID                         |
| `IsEnabled`          | boolean   | No       | —       | Whether the ad group is enabled              |
| `RTBAttributes`      | object    | No       | —       | RTB Attributes                               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdGroupName": {
        "type": "string",
        "description": "Display name of the ad group"
      },
      "AssociatedBidLists": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "BidListId": {
              "type": "string",
              "description": "ID of the bid list"
            },
            "IsEnabled": {
              "type": "boolean",
              "description": "Whether the association is active"
            }
          }
        },
        "description": "Bid lists associated with this ad group"
      },
      "CampaignId": {
        "type": "string",
        "description": "ID of the campaign this ad group belongs to"
      },
      "CreativeIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Creative IDs to associate with this ad group"
      },
      "Description": {
        "type": "string",
        "description": "Optional description"
      },
      "IndustryCategoryId": {
        "type": "integer",
        "description": "Industry category ID"
      },
      "IsEnabled": {
        "type": "boolean",
        "description": "Whether the ad group is enabled"
      },
      "RTBAttributes": {
        "type": "object",
        "description": "RTB Attributes",
        "properties": {
          "BudgetSettings": {
            "type": "object",
            "description": "Budget Settings"
          },
          "BaseBidCPM": {
            "type": "object",
            "description": "Base Bid CPM"
          },
          "MaxBidCPM": {
            "type": "object",
            "description": "Max Bid CPM"
          },
          "ROIGoal": {
            "type": "object",
            "description": "ROI Goal"
          }
        }
      }
    },
    "required": [
      "PCID",
      "AdGroupName",
      "CampaignId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_create\_advertiser

Create a new advertiser

**Parameters:**

| Parameter            | Type    | Required | Default | Description                                       |
| -------------------- | ------- | -------- | ------- | ------------------------------------------------- |
| `AdvertiserName`     | string  | Yes      | —       | Display name of the advertiser                    |
| `CurrencyCode`       | string  | Yes      | —       | Currency code for the advertiser (e.g., USD, EUR) |
| `Description`        | string  | No       | —       | Optional description of the advertiser            |
| `DomainAddress`      | string  | No       | —       | Primary website URL for the advertiser            |
| `IndustryCategoryId` | integer | No       | —       | Industry category ID for the advertiser           |
| `PartnerId`          | string  | Yes      | —       | ID of the partner that owns this advertiser       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserName": {
        "type": "string",
        "description": "Display name of the advertiser"
      },
      "CurrencyCode": {
        "type": "string",
        "description": "Currency code for the advertiser (e.g., USD, EUR)"
      },
      "Description": {
        "type": "string",
        "description": "Optional description of the advertiser"
      },
      "DomainAddress": {
        "type": "string",
        "description": "Primary website URL for the advertiser"
      },
      "IndustryCategoryId": {
        "type": "integer",
        "description": "Industry category ID for the advertiser"
      },
      "PartnerId": {
        "type": "string",
        "description": "ID of the partner that owns this advertiser"
      }
    },
    "required": [
      "PCID",
      "AdvertiserName",
      "CurrencyCode",
      "PartnerId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_create\_audience

Create a new audience segment

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                  |
| -------------- | ------ | -------- | ------- | -------------------------------------------- |
| `AdvertiserId` | string | Yes      | —       | ID of the advertiser that owns this audience |
| `AudienceName` | string | Yes      | —       | Display name of the audience                 |
| `Description`  | string | No       | —       | Optional description                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "ID of the advertiser that owns this audience"
      },
      "AudienceName": {
        "type": "string",
        "description": "Display name of the audience"
      },
      "Description": {
        "type": "string",
        "description": "Optional description"
      }
    },
    "required": [
      "PCID",
      "AdvertiserId",
      "AudienceName"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_create\_bid\_list

Create a new bid list

**Parameters:**

| Parameter               | Type   | Required | Default | Description                                            |
| ----------------------- | ------ | -------- | ------- | ------------------------------------------------------ |
| `AdvertiserId`          | string | No       | —       | Advertiser ID (required if BidListOwner is Advertiser) |
| `BidListAdjustmentType` | string | No       | —       | Type of bid adjustment                                 |
| `BidListName`           | string | Yes      | —       | Display name of the bid list                           |
| `BidListOwner`          | string | Yes      | —       | Owner type (Advertiser or Partner)                     |
| `BidListSource`         | string | No       | —       | Source of the bid list                                 |
| `Description`           | string | No       | —       | The description value                                  |
| `PartnerId`             | string | No       | —       | Partner ID (required if BidListOwner is Partner)       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "Advertiser ID (required if BidListOwner is Advertiser)"
      },
      "BidListAdjustmentType": {
        "type": "string",
        "description": "Type of bid adjustment",
        "enum": [
          "BlockList",
          "TargetList"
        ]
      },
      "BidListName": {
        "type": "string",
        "description": "Display name of the bid list"
      },
      "BidListOwner": {
        "type": "string",
        "description": "Owner type (Advertiser or Partner)",
        "enum": [
          "Advertiser",
          "Partner"
        ]
      },
      "BidListSource": {
        "type": "string",
        "description": "Source of the bid list",
        "enum": [
          "Manual",
          "ThirdParty"
        ]
      },
      "Description": {
        "type": "string",
        "description": "The description value"
      },
      "PartnerId": {
        "type": "string",
        "description": "Partner ID (required if BidListOwner is Partner)"
      }
    },
    "required": [
      "PCID",
      "BidListName",
      "BidListOwner"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_create\_campaign

Create a new campaign

**Parameters:**

| Parameter                            | Type      | Required | Default | Description                                  |
| ------------------------------------ | --------- | -------- | ------- | -------------------------------------------- |
| `AdvertiserId`                       | string    | Yes      | —       | ID of the advertiser that owns this campaign |
| `Budget`                             | object    | Yes      | —       | The budget value                             |
| `CampaignConversionReportingColumns` | string\[] | No       | —       | Conversion reporting column IDs to associate |
| `CampaignName`                       | string    | Yes      | —       | Display name of the campaign                 |
| `DailyBudget`                        | object    | No       | —       | Daily Budget                                 |
| `Description`                        | string    | No       | —       | Optional campaign description                |
| `EndDate`                            | string    | No       | —       | Campaign end date in UTC (ISO 8601 format)   |
| `FrequencyConfig`                    | object    | No       | —       | Frequency Config                             |
| `PacingMode`                         | string    | No       | —       | Budget pacing mode                           |
| `PartnerCostPercentageFee`           | number    | No       | —       | Partner cost percentage fee                  |
| `StartDate`                          | string    | Yes      | —       | Campaign start date in UTC (ISO 8601 format) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "ID of the advertiser that owns this campaign"
      },
      "Budget": {
        "type": "object",
        "description": "The budget value",
        "properties": {
          "Amount": {
            "type": "number",
            "description": "Budget amount in advertiser currency"
          },
          "CurrencyCode": {
            "type": "string",
            "description": "Currency code (e.g., USD)"
          }
        }
      },
      "CampaignConversionReportingColumns": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Conversion reporting column IDs to associate"
      },
      "CampaignName": {
        "type": "string",
        "description": "Display name of the campaign"
      },
      "DailyBudget": {
        "type": "object",
        "description": "Daily Budget",
        "properties": {
          "Amount": {
            "type": "number",
            "description": "Budget amount in advertiser currency"
          },
          "CurrencyCode": {
            "type": "string",
            "description": "Currency code (e.g., USD)"
          }
        }
      },
      "Description": {
        "type": "string",
        "description": "Optional campaign description"
      },
      "EndDate": {
        "type": "string",
        "description": "Campaign end date in UTC (ISO 8601 format)"
      },
      "FrequencyConfig": {
        "type": "object",
        "description": "Frequency Config",
        "properties": {
          "MaxImpressions": {
            "type": "integer",
            "description": "Maximum number of impressions per period"
          },
          "PeriodInMinutes": {
            "type": "integer",
            "description": "Frequency cap period in minutes"
          }
        }
      },
      "PacingMode": {
        "type": "string",
        "description": "Budget pacing mode",
        "enum": [
          "PaceAhead",
          "PaceToEnd",
          "Off"
        ]
      },
      "PartnerCostPercentageFee": {
        "type": "number",
        "description": "Partner cost percentage fee"
      },
      "StartDate": {
        "type": "string",
        "description": "Campaign start date in UTC (ISO 8601 format)"
      }
    },
    "required": [
      "PCID",
      "AdvertiserId",
      "Budget",
      "CampaignName",
      "StartDate"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_create\_campaign\_flight

Create a campaign flight (budget allocation period)

**Parameters:**

| Parameter                         | Type   | Required | Default | Description                                |
| --------------------------------- | ------ | -------- | ------- | ------------------------------------------ |
| `BudgetInAdvertiserCurrency`      | number | Yes      | —       | Budget amount in the advertiser's currency |
| `CampaignId`                      | string | Yes      | —       | ID of the campaign this flight belongs to  |
| `DailyTargetInAdvertiserCurrency` | number | No       | —       | Daily budget target                        |
| `EndDate`                         | string | No       | —       | Flight end date in UTC                     |
| `StartDate`                       | string | Yes      | —       | Flight start date in UTC                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "BudgetInAdvertiserCurrency": {
        "type": "number",
        "description": "Budget amount in the advertiser's currency"
      },
      "CampaignId": {
        "type": "string",
        "description": "ID of the campaign this flight belongs to"
      },
      "DailyTargetInAdvertiserCurrency": {
        "type": "number",
        "description": "Daily budget target"
      },
      "EndDate": {
        "type": "string",
        "description": "Flight end date in UTC"
      },
      "StartDate": {
        "type": "string",
        "description": "Flight start date in UTC"
      }
    },
    "required": [
      "PCID",
      "BudgetInAdvertiserCurrency",
      "CampaignId",
      "StartDate"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_create\_creative

Create a new creative

**Parameters:**

| Parameter        | Type      | Required | Default | Description                                  |
| ---------------- | --------- | -------- | ------- | -------------------------------------------- |
| `AdvertiserId`   | string    | Yes      | —       | ID of the advertiser that owns this creative |
| `Attributes`     | object    | No       | —       | The attributes value                         |
| `Availability`   | string    | Yes      | —       | Creative availability status                 |
| `CreativeName`   | string    | Yes      | —       | Display name of the creative                 |
| `Description`    | string    | No       | —       | Optional description                         |
| `IsHTTPS`        | boolean   | No       | —       | Whether the creative serves over HTTPS       |
| `LandingPageUrl` | string    | No       | —       | Click-through URL                            |
| `Tag`            | string    | No       | —       | The ad tag or creative markup                |
| `ThirdPartyTags` | object\[] | No       | —       | Third-party tracking tags                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "ID of the advertiser that owns this creative"
      },
      "Attributes": {
        "type": "object",
        "description": "The attributes value",
        "properties": {
          "ImageAttributes": {
            "type": "object",
            "description": "Image Attributes"
          },
          "VideoAttributes": {
            "type": "object",
            "description": "Video Attributes"
          }
        }
      },
      "Availability": {
        "type": "string",
        "description": "Creative availability status",
        "enum": [
          "Available",
          "Archived"
        ]
      },
      "CreativeName": {
        "type": "string",
        "description": "Display name of the creative"
      },
      "Description": {
        "type": "string",
        "description": "Optional description"
      },
      "IsHTTPS": {
        "type": "boolean",
        "description": "Whether the creative serves over HTTPS"
      },
      "LandingPageUrl": {
        "type": "string",
        "description": "Click-through URL"
      },
      "Tag": {
        "type": "string",
        "description": "The ad tag or creative markup"
      },
      "ThirdPartyTags": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "TagUrl": {
              "type": "string",
              "description": "URL for the third-party tag"
            },
            "TagType": {
              "type": "string",
              "enum": [
                "Impression",
                "Click"
              ],
              "description": "Type of third-party tag"
            }
          }
        },
        "description": "Third-party tracking tags"
      }
    },
    "required": [
      "PCID",
      "AdvertiserId",
      "Availability",
      "CreativeName"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_delete\_bid\_list

Delete a bid list

**Parameters:**

| Parameter   | Type   | Required | Default | Description     |
| ----------- | ------ | -------- | ------- | --------------- |
| `bidListId` | string | Yes      | —       | The bid list ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "bidListId": {
        "type": "string",
        "description": "The bid list ID"
      }
    },
    "required": [
      "PCID",
      "bidListId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_ad\_group

Retrieve an ad group by ID

**Parameters:**

| Parameter   | Type   | Required | Default | Description     |
| ----------- | ------ | -------- | ------- | --------------- |
| `adGroupId` | string | Yes      | —       | The ad group ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "adGroupId": {
        "type": "string",
        "description": "The ad group ID"
      }
    },
    "required": [
      "PCID",
      "adGroupId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_ad\_group\_status

Get the status of an ad group

**Parameters:**

| Parameter   | Type   | Required | Default | Description     |
| ----------- | ------ | -------- | ------- | --------------- |
| `adGroupId` | string | Yes      | —       | The ad group ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "adGroupId": {
        "type": "string",
        "description": "The ad group ID"
      }
    },
    "required": [
      "PCID",
      "adGroupId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_advertiser

Retrieve an advertiser by ID

**Parameters:**

| Parameter      | Type   | Required | Default | Description       |
| -------------- | ------ | -------- | ------- | ----------------- |
| `advertiserId` | string | Yes      | —       | The advertiser ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "advertiserId": {
        "type": "string",
        "description": "The advertiser ID"
      }
    },
    "required": [
      "PCID",
      "advertiserId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_audience

Retrieve an audience by ID

**Parameters:**

| Parameter    | Type   | Required | Default | Description     |
| ------------ | ------ | -------- | ------- | --------------- |
| `audienceId` | string | Yes      | —       | The audience ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "audienceId": {
        "type": "string",
        "description": "The audience ID"
      }
    },
    "required": [
      "PCID",
      "audienceId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_bid\_list

Retrieve a bid list by ID

**Parameters:**

| Parameter   | Type   | Required | Default | Description     |
| ----------- | ------ | -------- | ------- | --------------- |
| `bidListId` | string | Yes      | —       | The bid list ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "bidListId": {
        "type": "string",
        "description": "The bid list ID"
      }
    },
    "required": [
      "PCID",
      "bidListId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_campaign

Retrieve a campaign by ID

**Parameters:**

| Parameter    | Type   | Required | Default | Description     |
| ------------ | ------ | -------- | ------- | --------------- |
| `campaignId` | string | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaignId": {
        "type": "string",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaignId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_campaign\_flight

Retrieve a campaign flight by ID

**Parameters:**

| Parameter          | Type   | Required | Default | Description            |
| ------------------ | ------ | -------- | ------- | ---------------------- |
| `campaignFlightId` | string | Yes      | —       | The campaign flight ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaignFlightId": {
        "type": "string",
        "description": "The campaign flight ID"
      }
    },
    "required": [
      "PCID",
      "campaignFlightId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_campaign\_metrics

Get performance metrics for a campaign

**Parameters:**

| Parameter    | Type   | Required | Default | Description     |
| ------------ | ------ | -------- | ------- | --------------- |
| `campaignId` | string | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaignId": {
        "type": "string",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaignId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_get\_creative

Retrieve a creative by ID

**Parameters:**

| Parameter    | Type   | Required | Default | Description     |
| ------------ | ------ | -------- | ------- | --------------- |
| `creativeId` | string | Yes      | —       | The creative ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "creativeId": {
        "type": "string",
        "description": "The creative ID"
      }
    },
    "required": [
      "PCID",
      "creativeId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_query\_ad\_groups\_by\_campaign

Query ad groups by campaign ID

**Parameters:**

| Parameter        | Type      | Required | Default | Description                                       |
| ---------------- | --------- | -------- | ------- | ------------------------------------------------- |
| `CampaignId`     | string    | Yes      | —       | ID of the campaign to query ad groups for         |
| `PageSize`       | integer   | No       | —       | Number of results per page                        |
| `PageStartIndex` | integer   | No       | —       | Page Start Index                                  |
| `SearchTerms`    | string\[] | No       | —       | Optional search terms to filter ad groups by name |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "CampaignId": {
        "type": "string",
        "description": "ID of the campaign to query ad groups for"
      },
      "PageSize": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "PageStartIndex": {
        "type": "integer",
        "description": "Page Start Index"
      },
      "SearchTerms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional search terms to filter ad groups by name"
      }
    },
    "required": [
      "PCID",
      "CampaignId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_query\_advertisers\_by\_partner

Query advertisers by partner ID

**Parameters:**

| Parameter        | Type      | Required | Default | Description                                         |
| ---------------- | --------- | -------- | ------- | --------------------------------------------------- |
| `PageSize`       | integer   | No       | —       | Number of results per page                          |
| `PageStartIndex` | integer   | No       | —       | Zero-based index of the first result to return      |
| `PartnerId`      | string    | Yes      | —       | ID of the partner to query advertisers for          |
| `SearchTerms`    | string\[] | No       | —       | Optional search terms to filter advertisers by name |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "PageSize": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "PageStartIndex": {
        "type": "integer",
        "description": "Zero-based index of the first result to return"
      },
      "PartnerId": {
        "type": "string",
        "description": "ID of the partner to query advertisers for"
      },
      "SearchTerms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional search terms to filter advertisers by name"
      }
    },
    "required": [
      "PCID",
      "PartnerId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_query\_campaigns\_by\_advertiser

Query campaigns by advertiser ID

**Parameters:**

| Parameter        | Type      | Required | Default | Description                                       |
| ---------------- | --------- | -------- | ------- | ------------------------------------------------- |
| `AdvertiserId`   | string    | Yes      | —       | ID of the advertiser to query campaigns for       |
| `PageSize`       | integer   | No       | —       | Number of results per page                        |
| `PageStartIndex` | integer   | No       | —       | Page Start Index                                  |
| `SearchTerms`    | string\[] | No       | —       | Optional search terms to filter campaigns by name |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "ID of the advertiser to query campaigns for"
      },
      "PageSize": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "PageStartIndex": {
        "type": "integer",
        "description": "Page Start Index"
      },
      "SearchTerms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional search terms to filter campaigns by name"
      }
    },
    "required": [
      "PCID",
      "AdvertiserId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_query\_creatives\_by\_advertiser

Query creatives by advertiser ID

**Parameters:**

| Parameter        | Type      | Required | Default | Description                                 |
| ---------------- | --------- | -------- | ------- | ------------------------------------------- |
| `AdvertiserId`   | string    | Yes      | —       | ID of the advertiser to query creatives for |
| `PageSize`       | integer   | No       | —       | Number of results per page                  |
| `PageStartIndex` | integer   | No       | —       | Page Start Index                            |
| `SearchTerms`    | string\[] | No       | —       | Optional search terms to filter by name     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "ID of the advertiser to query creatives for"
      },
      "PageSize": {
        "type": "integer",
        "description": "Number of results per page"
      },
      "PageStartIndex": {
        "type": "integer",
        "description": "Page Start Index"
      },
      "SearchTerms": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional search terms to filter by name"
      }
    },
    "required": [
      "PCID",
      "AdvertiserId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_ad\_group

Update an existing ad group

**Parameters:**

| Parameter            | Type      | Required | Default | Description                  |
| -------------------- | --------- | -------- | ------- | ---------------------------- |
| `AdGroupId`          | string    | Yes      | —       | ID of the ad group to update |
| `AdGroupName`        | string    | No       | —       | Ad Group Name                |
| `AssociatedBidLists` | object\[] | No       | —       | Associated Bid Lists         |
| `CreativeIds`        | string\[] | No       | —       | Creative Ids                 |
| `Description`        | string    | No       | —       | The description value        |
| `IndustryCategoryId` | integer   | No       | —       | Industry Category Id         |
| `IsEnabled`          | boolean   | No       | —       | Is Enabled                   |
| `RTBAttributes`      | object    | No       | —       | RTB Attributes               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdGroupId": {
        "type": "string",
        "description": "ID of the ad group to update"
      },
      "AdGroupName": {
        "type": "string",
        "description": "Ad Group Name"
      },
      "AssociatedBidLists": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "BidListId": {
              "type": "string",
              "description": "ID of the bid list"
            },
            "IsEnabled": {
              "type": "boolean",
              "description": "Whether the association is active"
            }
          }
        },
        "description": "Associated Bid Lists"
      },
      "CreativeIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Creative Ids"
      },
      "Description": {
        "type": "string",
        "description": "The description value"
      },
      "IndustryCategoryId": {
        "type": "integer",
        "description": "Industry Category Id"
      },
      "IsEnabled": {
        "type": "boolean",
        "description": "Is Enabled"
      },
      "RTBAttributes": {
        "type": "object",
        "description": "RTB Attributes",
        "properties": {
          "BudgetSettings": {
            "type": "object",
            "description": "Budget Settings"
          },
          "BaseBidCPM": {
            "type": "object",
            "description": "Base Bid CPM"
          },
          "MaxBidCPM": {
            "type": "object",
            "description": "Max Bid CPM"
          },
          "ROIGoal": {
            "type": "object",
            "description": "ROI Goal"
          }
        }
      }
    },
    "required": [
      "PCID",
      "AdGroupId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_advertiser

Update an existing advertiser

**Parameters:**

| Parameter            | Type    | Required | Default | Description                    |
| -------------------- | ------- | -------- | ------- | ------------------------------ |
| `AdvertiserId`       | string  | Yes      | —       | ID of the advertiser to update |
| `AdvertiserName`     | string  | No       | —       | Updated display name           |
| `Description`        | string  | No       | —       | Updated description            |
| `DomainAddress`      | string  | No       | —       | Updated primary website URL    |
| `IndustryCategoryId` | integer | No       | —       | Updated industry category ID   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AdvertiserId": {
        "type": "string",
        "description": "ID of the advertiser to update"
      },
      "AdvertiserName": {
        "type": "string",
        "description": "Updated display name"
      },
      "Description": {
        "type": "string",
        "description": "Updated description"
      },
      "DomainAddress": {
        "type": "string",
        "description": "Updated primary website URL"
      },
      "IndustryCategoryId": {
        "type": "integer",
        "description": "Updated industry category ID"
      }
    },
    "required": [
      "PCID",
      "AdvertiserId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_audience

Update an existing audience

**Parameters:**

| Parameter      | Type   | Required | Default | Description                  |
| -------------- | ------ | -------- | ------- | ---------------------------- |
| `AudienceId`   | string | Yes      | —       | ID of the audience to update |
| `AudienceName` | string | No       | —       | Audience Name                |
| `Description`  | string | No       | —       | The description value        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "AudienceId": {
        "type": "string",
        "description": "ID of the audience to update"
      },
      "AudienceName": {
        "type": "string",
        "description": "Audience Name"
      },
      "Description": {
        "type": "string",
        "description": "The description value"
      }
    },
    "required": [
      "PCID",
      "AudienceId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_bid\_list

Update an existing bid list

**Parameters:**

| Parameter     | Type   | Required | Default | Description                  |
| ------------- | ------ | -------- | ------- | ---------------------------- |
| `BidListId`   | string | Yes      | —       | ID of the bid list to update |
| `BidListName` | string | No       | —       | Bid List Name                |
| `Description` | string | No       | —       | The description value        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "BidListId": {
        "type": "string",
        "description": "ID of the bid list to update"
      },
      "BidListName": {
        "type": "string",
        "description": "Bid List Name"
      },
      "Description": {
        "type": "string",
        "description": "The description value"
      }
    },
    "required": [
      "PCID",
      "BidListId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_campaign

Update an existing campaign

**Parameters:**

| Parameter         | Type   | Required | Default | Description                  |
| ----------------- | ------ | -------- | ------- | ---------------------------- |
| `Budget`          | object | No       | —       | The budget value             |
| `CampaignId`      | string | Yes      | —       | ID of the campaign to update |
| `CampaignName`    | string | No       | —       | Updated display name         |
| `DailyBudget`     | object | No       | —       | Daily Budget                 |
| `Description`     | string | No       | —       | The description value        |
| `EndDate`         | string | No       | —       | Updated end date             |
| `FrequencyConfig` | object | No       | —       | Frequency Config             |
| `PacingMode`      | string | No       | —       | Pacing Mode                  |
| `StartDate`       | string | No       | —       | Updated start date           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Budget": {
        "type": "object",
        "description": "The budget value",
        "properties": {
          "Amount": {
            "type": "number",
            "description": "Budget amount in advertiser currency"
          },
          "CurrencyCode": {
            "type": "string",
            "description": "Currency code (e.g., USD)"
          }
        }
      },
      "CampaignId": {
        "type": "string",
        "description": "ID of the campaign to update"
      },
      "CampaignName": {
        "type": "string",
        "description": "Updated display name"
      },
      "DailyBudget": {
        "type": "object",
        "description": "Daily Budget",
        "properties": {
          "Amount": {
            "type": "number",
            "description": "Budget amount in advertiser currency"
          },
          "CurrencyCode": {
            "type": "string",
            "description": "Currency code (e.g., USD)"
          }
        }
      },
      "Description": {
        "type": "string",
        "description": "The description value"
      },
      "EndDate": {
        "type": "string",
        "description": "Updated end date"
      },
      "FrequencyConfig": {
        "type": "object",
        "description": "Frequency Config",
        "properties": {
          "MaxImpressions": {
            "type": "integer",
            "description": "Maximum number of impressions per period"
          },
          "PeriodInMinutes": {
            "type": "integer",
            "description": "Frequency cap period in minutes"
          }
        }
      },
      "PacingMode": {
        "type": "string",
        "description": "Pacing Mode",
        "enum": [
          "PaceAhead",
          "PaceToEnd",
          "Off"
        ]
      },
      "StartDate": {
        "type": "string",
        "description": "Updated start date"
      }
    },
    "required": [
      "PCID",
      "CampaignId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_campaign\_flight

Update a campaign flight

**Parameters:**

| Parameter                         | Type   | Required | Default | Description                         |
| --------------------------------- | ------ | -------- | ------- | ----------------------------------- |
| `BudgetInAdvertiserCurrency`      | number | No       | —       | Budget In Advertiser Currency       |
| `CampaignFlightId`                | string | Yes      | —       | ID of the campaign flight to update |
| `DailyTargetInAdvertiserCurrency` | number | No       | —       | Daily Target In Advertiser Currency |
| `EndDate`                         | string | No       | —       | End date for filtering              |
| `StartDate`                       | string | No       | —       | Start date for filtering            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "BudgetInAdvertiserCurrency": {
        "type": "number",
        "description": "Budget In Advertiser Currency"
      },
      "CampaignFlightId": {
        "type": "string",
        "description": "ID of the campaign flight to update"
      },
      "DailyTargetInAdvertiserCurrency": {
        "type": "number",
        "description": "Daily Target In Advertiser Currency"
      },
      "EndDate": {
        "type": "string",
        "description": "End date for filtering"
      },
      "StartDate": {
        "type": "string",
        "description": "Start date for filtering"
      }
    },
    "required": [
      "PCID",
      "CampaignFlightId"
    ]
  }
  ```
</Expandable>

***

## the\_trade\_desk\_update\_creative

Update an existing creative

**Parameters:**

| Parameter        | Type      | Required | Default | Description                  |
| ---------------- | --------- | -------- | ------- | ---------------------------- |
| `Attributes`     | object    | No       | —       | The attributes value         |
| `Availability`   | string    | No       | —       | The availability value       |
| `CreativeId`     | string    | Yes      | —       | ID of the creative to update |
| `CreativeName`   | string    | No       | —       | Creative Name                |
| `Description`    | string    | No       | —       | The description value        |
| `IsHTTPS`        | boolean   | No       | —       | Is HTTPS                     |
| `LandingPageUrl` | string    | No       | —       | Landing Page Url             |
| `Tag`            | string    | No       | —       | The tag value                |
| `ThirdPartyTags` | object\[] | No       | —       | Third Party Tags             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Attributes": {
        "type": "object",
        "description": "The attributes value",
        "properties": {
          "ImageAttributes": {
            "type": "object",
            "description": "Image Attributes"
          },
          "VideoAttributes": {
            "type": "object",
            "description": "Video Attributes"
          }
        }
      },
      "Availability": {
        "type": "string",
        "description": "The availability value",
        "enum": [
          "Available",
          "Archived"
        ]
      },
      "CreativeId": {
        "type": "string",
        "description": "ID of the creative to update"
      },
      "CreativeName": {
        "type": "string",
        "description": "Creative Name"
      },
      "Description": {
        "type": "string",
        "description": "The description value"
      },
      "IsHTTPS": {
        "type": "boolean",
        "description": "Is HTTPS"
      },
      "LandingPageUrl": {
        "type": "string",
        "description": "Landing Page Url"
      },
      "Tag": {
        "type": "string",
        "description": "The tag value"
      },
      "ThirdPartyTags": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "TagUrl": {
              "type": "string",
              "description": "URL for the third-party tag"
            },
            "TagType": {
              "type": "string",
              "enum": [
                "Impression",
                "Click"
              ],
              "description": "Type of third-party tag"
            }
          }
        },
        "description": "Third Party Tags"
      }
    },
    "required": [
      "PCID",
      "CreativeId"
    ]
  }
  ```
</Expandable>