> ## 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.

# marketo-programs

> Marketo Programs

**Server path:** `/marketo-programs` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                            | Description                         |
| --------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| [`marketo-programs_activate_smart_campaign`](#marketo-programs_activate_smart_campaign)                         | Activate Smart Campaign             |
| [`marketo-programs_approve_program`](#marketo-programs_approve_program)                                         | Approve Program                     |
| [`marketo-programs_browse_folders`](#marketo-programs_browse_folders)                                           | Get Folders                         |
| [`marketo-programs_browse_programs`](#marketo-programs_browse_programs)                                         | Get Programs                        |
| [`marketo-programs_clone_program`](#marketo-programs_clone_program)                                             | Clone Program                       |
| [`marketo-programs_clone_smart_campaign`](#marketo-programs_clone_smart_campaign)                               | Clone Smart Campaign                |
| [`marketo-programs_create_folder`](#marketo-programs_create_folder)                                             | Create Folder                       |
| [`marketo-programs_create_program`](#marketo-programs_create_program)                                           | Create Program                      |
| [`marketo-programs_create_smart_campaign`](#marketo-programs_create_smart_campaign)                             | Create Smart Campaign               |
| [`marketo-programs_deactivate_smart_campaign`](#marketo-programs_deactivate_smart_campaign)                     | Deactivate Smart Campaign           |
| [`marketo-programs_delete_program`](#marketo-programs_delete_program)                                           | Delete Program                      |
| [`marketo-programs_delete_smart_campaign`](#marketo-programs_delete_smart_campaign)                             | Delete Smart Campaign               |
| [`marketo-programs_get_all_smart_campaigns`](#marketo-programs_get_all_smart_campaigns)                         | Get Smart Campaigns                 |
| [`marketo-programs_get_folder_by_id`](#marketo-programs_get_folder_by_id)                                       | Get Folder by Id                    |
| [`marketo-programs_get_folder_by_name`](#marketo-programs_get_folder_by_name)                                   | Get Folder by Name                  |
| [`marketo-programs_get_folder_content`](#marketo-programs_get_folder_content)                                   | Get Folder Contents                 |
| [`marketo-programs_get_program_by_id`](#marketo-programs_get_program_by_id)                                     | Get Program by Id                   |
| [`marketo-programs_get_program_by_name`](#marketo-programs_get_program_by_name)                                 | Get Program by Name                 |
| [`marketo-programs_get_program_list_by_tag`](#marketo-programs_get_program_list_by_tag)                         | Get Programs by Tag                 |
| [`marketo-programs_get_smart_campaign_by_id`](#marketo-programs_get_smart_campaign_by_id)                       | Get Smart Campaign by Id            |
| [`marketo-programs_get_smart_campaign_by_name`](#marketo-programs_get_smart_campaign_by_name)                   | Get Smart Campaign by Name          |
| [`marketo-programs_get_smart_list_by_program_id`](#marketo-programs_get_smart_list_by_program_id)               | Get Smart List by Program Id        |
| [`marketo-programs_get_smart_list_by_smart_campaign_id`](#marketo-programs_get_smart_list_by_smart_campaign_id) | Get Smart List by Smart Campaign Id |
| [`marketo-programs_unapprove_program`](#marketo-programs_unapprove_program)                                     | Unapprove Program                   |
| [`marketo-programs_update_folder`](#marketo-programs_update_folder)                                             | Update Folder Metadata              |
| [`marketo-programs_update_program`](#marketo-programs_update_program)                                           | Update Program Metadata             |
| [`marketo-programs_update_smart_campaign`](#marketo-programs_update_smart_campaign)                             | Update Smart Campaign               |

***

## marketo-programs\_activate\_smart\_campaign

Activate Smart Campaign

**Parameters:**

| Parameter | Type    | Required | Default | Description              |
| --------- | ------- | -------- | ------- | ------------------------ |
| `id`      | integer | Yes      | —       | Id of the smart campaign |

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

***

## marketo-programs\_approve\_program

Approve Program

**Parameters:**

| Parameter | Type    | Required | Default | Description  |
| --------- | ------- | -------- | ------- | ------------ |
| `id`      | integer | Yes      | —       | The id value |

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

***

## marketo-programs\_browse\_folders

Get Folders

**Parameters:**

| Parameter   | Type    | Required | Default | Description                                                  |
| ----------- | ------- | -------- | ------- | ------------------------------------------------------------ |
| `root`      | string  | No       | —       | Parent folder reference                                      |
| `maxDepth`  | integer | No       | —       | Maximum folder depth to traverse, Default 2                  |
| `maxReturn` | integer | No       | —       | Maximum number of folders to return. Default 20, maximum 200 |
| `offset`    | integer | No       | —       | Integer offset for paging. Default 0                         |
| `workSpace` | string  | No       | —       | Name of the workspace                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "root": {
        "type": "string",
        "description": "Parent folder reference"
      },
      "maxDepth": {
        "type": "integer",
        "description": "Maximum folder depth to traverse, Default 2"
      },
      "maxReturn": {
        "type": "integer",
        "description": "Maximum number of folders to return. Default 20, maximum 200"
      },
      "offset": {
        "type": "integer",
        "description": "Integer offset for paging. Default 0"
      },
      "workSpace": {
        "type": "string",
        "description": "Name of the workspace"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_browse\_programs

Get Programs

**Parameters:**

| Parameter           | Type    | Required | Default | Description                                                                                                                                                                                         |
| ------------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `maxReturn`         | integer | No       | —       | Maximum number of records to return. Max 200, default 20                                                                                                                                            |
| `offset`            | integer | No       | —       | Integer offset for paging                                                                                                                                                                           |
| `filterType`        | string  | No       | —       | Optional filter. Requires filterValues                                                                                                                                                              |
| `earliestUpdatedAt` | string  | No       | —       | Exclude programs prior to this date. Must be valid ISO-8601 string. See \<a href="`http://developers.marketo.com/rest-api/lead-database/fields/field-types/`">Datetime\</a> field type description. |
| `latestUpdatedAt`   | string  | No       | —       | Exclude programs after this date. Must be valid ISO-8601 string. See \<a href="`http://developers.marketo.com/rest-api/lead-database/fields/field-types/`">Datetime\</a> field type description.    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "maxReturn": {
        "type": "integer",
        "description": "Maximum number of records to return. Max 200, default 20"
      },
      "offset": {
        "type": "integer",
        "description": "Integer offset for paging"
      },
      "filterType": {
        "type": "string",
        "description": "Optional filter. Requires filterValues",
        "enum": [
          "id",
          "programId",
          "folderId",
          "workspace"
        ]
      },
      "earliestUpdatedAt": {
        "type": "string",
        "description": "Exclude programs prior to this date. Must be valid ISO-8601 string. See <a href=\"http://developers.marketo.com/rest-api/lead-database/fields/field-types/\">Datetime</a> field type description."
      },
      "latestUpdatedAt": {
        "type": "string",
        "description": "Exclude programs after this date. Must be valid ISO-8601 string. See <a href=\"http://developers.marketo.com/rest-api/lead-database/fields/field-types/\">Datetime</a> field type description."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_clone\_program

Clone Program

**Parameters:**

| Parameter     | Type    | Required | Default | Description                             |
| ------------- | ------- | -------- | ------- | --------------------------------------- |
| `id`          | integer | Yes      | —       | The id value                            |
| `description` | string  | No       | —       | The description value                   |
| `folder`      | object  | Yes      | —       | JSON representation of a folder         |
| `name`        | string  | Yes      | —       | Name of the program. Max 255 characters |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "The id value"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "folder": {
        "type": "object",
        "description": "JSON representation of a folder",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the folder"
          },
          "type": {
            "type": "string",
            "description": "Type of folder",
            "enum": [
              "Folder",
              "Program"
            ]
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "name": {
        "type": "string",
        "description": "Name of the program. Max 255 characters"
      }
    },
    "required": [
      "PCID",
      "id",
      "folder",
      "name"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_clone\_smart\_campaign

Clone Smart Campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description                       |
| ------------- | ------- | -------- | ------- | --------------------------------- |
| `id`          | integer | Yes      | —       | Id of the smart campaign          |
| `description` | string  | No       | —       | Description of the smart campaign |
| `folder`      | object  | Yes      | —       | JSON representation of a folder   |
| `name`        | string  | Yes      | —       | Name of the smart campaign        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Id of the smart campaign"
      },
      "description": {
        "type": "string",
        "description": "Description of the smart campaign"
      },
      "folder": {
        "type": "object",
        "description": "JSON representation of a folder",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the folder"
          },
          "type": {
            "type": "string",
            "description": "Type of folder",
            "enum": [
              "Folder",
              "Program"
            ]
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "name": {
        "type": "string",
        "description": "Name of the smart campaign"
      }
    },
    "required": [
      "PCID",
      "id",
      "folder",
      "name"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_create\_folder

Create Folder

**Parameters:**

| Parameter     | Type   | Required | Default | Description                     |
| ------------- | ------ | -------- | ------- | ------------------------------- |
| `description` | string | No       | —       | Description of the asset        |
| `name`        | string | Yes      | —       | Name of the Folder              |
| `parent`      | object | Yes      | —       | JSON representation of a folder |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "description": {
        "type": "string",
        "description": "Description of the asset"
      },
      "name": {
        "type": "string",
        "description": "Name of the Folder"
      },
      "parent": {
        "type": "object",
        "description": "JSON representation of a folder",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the folder"
          },
          "type": {
            "type": "string",
            "description": "Type of folder",
            "enum": [
              "Folder",
              "Program"
            ]
          }
        },
        "required": [
          "id",
          "type"
        ]
      }
    },
    "required": [
      "PCID",
      "name",
      "parent"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_create\_program

Create Program

**Parameters:**

| Parameter     | Type      | Required | Default | Description                      |
| ------------- | --------- | -------- | ------- | -------------------------------- |
| `channel`     | string    | Yes      | —       | Channel of the program           |
| `costs`       | object\[] | No       | —       | Lists of associated period costs |
| `description` | string    | No       | —       | The description value            |
| `folder`      | object    | Yes      | —       | JSON representation of a folder  |
| `name`        | string    | Yes      | —       | Name of the program              |
| `tags`        | object\[] | No       | —       | List of associated program tags  |
| `type`        | string    | Yes      | —       | Type of the program              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "channel": {
        "type": "string",
        "description": "Channel of the program"
      },
      "costs": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "cost": {
              "type": "integer",
              "format": "int32",
              "description": "Amount of the cost"
            },
            "note": {
              "type": "string",
              "description": "Notes on the cost"
            },
            "startDate": {
              "type": "string",
              "format": "date-time",
              "description": "Start date of the period cost"
            }
          },
          "required": [
            "cost",
            "startDate"
          ]
        },
        "description": "Lists of associated period costs"
      },
      "description": {
        "type": "string",
        "description": "The description value"
      },
      "folder": {
        "type": "object",
        "description": "JSON representation of a folder",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the folder"
          },
          "type": {
            "type": "string",
            "description": "Type of folder",
            "enum": [
              "Folder",
              "Program"
            ]
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "name": {
        "type": "string",
        "description": "Name of the program"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "tagType": {
              "type": "string",
              "description": "Type of program tag"
            },
            "tagValue": {
              "type": "string",
              "description": "Value of the tag"
            }
          }
        },
        "description": "List of associated program tags"
      },
      "type": {
        "type": "string",
        "description": "Type of the program"
      }
    },
    "required": [
      "PCID",
      "channel",
      "folder",
      "name",
      "type"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_create\_smart\_campaign

Create Smart Campaign

**Parameters:**

| Parameter     | Type   | Required | Default | Description                       |
| ------------- | ------ | -------- | ------- | --------------------------------- |
| `description` | string | No       | —       | Description of the smart campaign |
| `folder`      | object | Yes      | —       | JSON representation of a folder   |
| `name`        | string | Yes      | —       | Name of the smart campaign        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "description": {
        "type": "string",
        "description": "Description of the smart campaign"
      },
      "folder": {
        "type": "object",
        "description": "JSON representation of a folder",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Id of the folder"
          },
          "type": {
            "type": "string",
            "description": "Type of folder",
            "enum": [
              "Folder",
              "Program"
            ]
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "name": {
        "type": "string",
        "description": "Name of the smart campaign"
      }
    },
    "required": [
      "PCID",
      "folder",
      "name"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_deactivate\_smart\_campaign

Deactivate Smart Campaign

**Parameters:**

| Parameter | Type    | Required | Default | Description              |
| --------- | ------- | -------- | ------- | ------------------------ |
| `id`      | integer | Yes      | —       | Id of the smart campaign |

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

***

## marketo-programs\_delete\_program

Delete Program

**Parameters:**

| Parameter | Type    | Required | Default | Description  |
| --------- | ------- | -------- | ------- | ------------ |
| `id`      | integer | Yes      | —       | The id value |

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

***

## marketo-programs\_delete\_smart\_campaign

Delete Smart Campaign

**Parameters:**

| Parameter | Type    | Required | Default | Description              |
| --------- | ------- | -------- | ------- | ------------------------ |
| `id`      | integer | Yes      | —       | Id of the smart campaign |

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

***

## marketo-programs\_get\_all\_smart\_campaigns

Get Smart Campaigns

**Parameters:**

| Parameter           | Type    | Required | Default | Description                                                                                                                                                                                                |
| ------------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `maxReturn`         | integer | No       | —       | Maximum number of smart campaigns to return. Max 200, default 20                                                                                                                                           |
| `offset`            | integer | No       | —       | Integer offset for paging                                                                                                                                                                                  |
| `folder`            | string  | No       | —       | JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'                                                                                                     |
| `earliestUpdatedAt` | string  | No       | —       | Exclude smart campaigns prior to this date. Must be valid ISO-8601 string. See \<a href="`http://developers.marketo.com/rest-api/lead-database/fields/field-types/`">Datetime\</a> field type description. |
| `latestUpdatedAt`   | string  | No       | —       | Exclude smart campaigns after this date. Must be valid ISO-8601 string. See \<a href="`http://developers.marketo.com/rest-api/lead-database/fields/field-types/`">Datetime\</a> field type description.    |
| `isActive`          | boolean | No       | —       | Set true to return only active campaigns. Default false                                                                                                                                                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "maxReturn": {
        "type": "integer",
        "description": "Maximum number of smart campaigns to return. Max 200, default 20"
      },
      "offset": {
        "type": "integer",
        "description": "Integer offset for paging"
      },
      "folder": {
        "type": "string",
        "description": "JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'"
      },
      "earliestUpdatedAt": {
        "type": "string",
        "description": "Exclude smart campaigns prior to this date. Must be valid ISO-8601 string. See <a href=\"http://developers.marketo.com/rest-api/lead-database/fields/field-types/\">Datetime</a> field type description."
      },
      "latestUpdatedAt": {
        "type": "string",
        "description": "Exclude smart campaigns after this date. Must be valid ISO-8601 string. See <a href=\"http://developers.marketo.com/rest-api/lead-database/fields/field-types/\">Datetime</a> field type description."
      },
      "isActive": {
        "type": "boolean",
        "description": "Set true to return only active campaigns. Default false"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_folder\_by\_id

Get Folder by Id

**Parameters:**

| Parameter | Type    | Required | Default | Description                           |
| --------- | ------- | -------- | ------- | ------------------------------------- |
| `id`      | integer | Yes      | —       | Id of the folder to retrieve          |
| `type`    | string  | Yes      | —       | Type of folder. 'Folder' or 'Program' |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Id of the folder to retrieve"
      },
      "type": {
        "type": "string",
        "description": "Type of folder. 'Folder' or 'Program'",
        "enum": [
          "Folder",
          "Program"
        ]
      }
    },
    "required": [
      "PCID",
      "id",
      "type"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_folder\_by\_name

Get Folder by Name

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                     |
| ----------- | ------ | -------- | ------- | ----------------------------------------------- |
| `name`      | string | Yes      | —       | Name of the folder. Not applicable for Programs |
| `type`      | string | No       | —       | Type of folder. 'Folder' or 'Program'           |
| `root`      | string | No       | —       | Parent folder reference                         |
| `workSpace` | string | No       | —       | Name of the workspace                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "name": {
        "type": "string",
        "description": "Name of the folder. Not applicable for Programs"
      },
      "type": {
        "type": "string",
        "description": "Type of folder. 'Folder' or 'Program'"
      },
      "root": {
        "type": "string",
        "description": "Parent folder reference"
      },
      "workSpace": {
        "type": "string",
        "description": "Name of the workspace"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_folder\_content

Get Folder Contents

**Parameters:**

| Parameter   | Type    | Required | Default | Description                                                |
| ----------- | ------- | -------- | ------- | ---------------------------------------------------------- |
| `id`        | integer | Yes      | —       | Id of the folder to retrieve                               |
| `maxReturn` | integer | No       | —       | Maximum number of records to return. Max 200, default 20   |
| `offset`    | integer | No       | —       | Integer offset for paging                                  |
| `type`      | string  | Yes      | —       | Type of folder. 'Folder' or 'Program'. Default is 'Folder' |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Id of the folder to retrieve"
      },
      "maxReturn": {
        "type": "integer",
        "description": "Maximum number of records to return. Max 200, default 20"
      },
      "offset": {
        "type": "integer",
        "description": "Integer offset for paging"
      },
      "type": {
        "type": "string",
        "description": "Type of folder. 'Folder' or 'Program'. Default is 'Folder'",
        "enum": [
          "Folder",
          "Program"
        ]
      }
    },
    "required": [
      "PCID",
      "id",
      "type"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_program\_by\_id

Get Program by Id

**Parameters:**

| Parameter | Type    | Required | Default | Description  |
| --------- | ------- | -------- | ------- | ------------ |
| `id`      | integer | Yes      | —       | The id value |

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

***

## marketo-programs\_get\_program\_by\_name

Get Program by Name

**Parameters:**

| Parameter      | Type    | Required | Default | Description                        |
| -------------- | ------- | -------- | ------- | ---------------------------------- |
| `name`         | string  | Yes      | —       | Name of the program                |
| `includeTags`  | boolean | No       | —       | Set true to populate program tags  |
| `includeCosts` | boolean | No       | —       | Set true to populate program costs |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "name": {
        "type": "string",
        "description": "Name of the program"
      },
      "includeTags": {
        "type": "boolean",
        "description": "Set true to populate program tags"
      },
      "includeCosts": {
        "type": "boolean",
        "description": "Set true to populate program costs"
      }
    },
    "required": [
      "PCID",
      "name"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_program\_list\_by\_tag

Get Programs by Tag

**Parameters:**

| Parameter   | Type    | Required | Default | Description                                              |
| ----------- | ------- | -------- | ------- | -------------------------------------------------------- |
| `tagType`   | string  | Yes      | —       | Type of program tag                                      |
| `tagValue`  | string  | Yes      | —       | Value of the tag                                         |
| `maxReturn` | integer | No       | —       | Maximum number of records to return. Max 200, default 20 |
| `offset`    | integer | No       | —       | Integer offset for paging                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tagType": {
        "type": "string",
        "description": "Type of program tag"
      },
      "tagValue": {
        "type": "string",
        "description": "Value of the tag"
      },
      "maxReturn": {
        "type": "integer",
        "description": "Maximum number of records to return. Max 200, default 20"
      },
      "offset": {
        "type": "integer",
        "description": "Integer offset for paging"
      }
    },
    "required": [
      "PCID",
      "tagType",
      "tagValue"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_smart\_campaign\_by\_id

Get Smart Campaign by Id

**Parameters:**

| Parameter | Type    | Required | Default | Description               |
| --------- | ------- | -------- | ------- | ------------------------- |
| `id`      | integer | Yes      | —       | Id for the smart campaign |

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

***

## marketo-programs\_get\_smart\_campaign\_by\_name

Get Smart Campaign by Name

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `name`    | string | Yes      | —       | Name for the smart campaign |

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

***

## marketo-programs\_get\_smart\_list\_by\_program\_id

Get Smart List by Program Id

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                                |
| -------------- | ------- | -------- | ------- | ---------------------------------------------------------- |
| `programId`    | integer | Yes      | —       | Id for the email program containing smart list to retrieve |
| `includeRules` | boolean | No       | —       | Set true to populate smart list rules. Default false       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "programId": {
        "type": "integer",
        "description": "Id for the email program containing smart list to retrieve"
      },
      "includeRules": {
        "type": "boolean",
        "description": "Set true to populate smart list rules. Default false"
      }
    },
    "required": [
      "PCID",
      "programId"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_get\_smart\_list\_by\_smart\_campaign\_id

Get Smart List by Smart Campaign Id

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                                 |
| -------------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `id`           | integer | Yes      | —       | Id for the smart campaign containing smart list to retrieve |
| `includeRules` | boolean | No       | —       | Set true to populate smart list rules. Default false        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Id for the smart campaign containing smart list to retrieve"
      },
      "includeRules": {
        "type": "boolean",
        "description": "Set true to populate smart list rules. Default false"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_unapprove\_program

Unapprove Program

**Parameters:**

| Parameter | Type    | Required | Default | Description  |
| --------- | ------- | -------- | ------- | ------------ |
| `id`      | integer | Yes      | —       | The id value |

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

***

## marketo-programs\_update\_folder

Update Folder Metadata

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                                                                              |
| ------------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------- |
| `id`          | integer | Yes      | —       | Id of the folder to update                                                                               |
| `description` | string  | No       | —       | Description of the asset                                                                                 |
| `isArchive`   | boolean | No       | —       | Whether the folder is archived or not. Toggling this value will change the archival status of the folder |
| `name`        | string  | No       | —       | Name of the Folder                                                                                       |
| `type`        | string  | Yes      | —       | Type of folder. 'Folder' or 'Program'                                                                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Id of the folder to update"
      },
      "description": {
        "type": "string",
        "description": "Description of the asset"
      },
      "isArchive": {
        "type": "boolean",
        "description": "Whether the folder is archived or not. Toggling this value will change the archival status of the folder"
      },
      "name": {
        "type": "string",
        "description": "Name of the Folder"
      },
      "type": {
        "type": "string",
        "description": "Type of folder. 'Folder' or 'Program'",
        "enum": [
          "Folder",
          "Program"
        ]
      }
    },
    "required": [
      "PCID",
      "id",
      "type"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_update\_program

Update Program Metadata

**Parameters:**

| Parameter                | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                                           |
| ------------------------ | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                     | integer   | Yes      | —       | The id value                                                                                                                                                                                                                                                                                                          |
| `costs`                  | object\[] | No       | —       | Lists of associated period costs that allow you to append, replace, or delete. To append new costs, simply add them to costs array. To replace costs (destructive update), pass new costs and set costsDestructiveUpdate to true. To delete costs, do not pass costs parameter and set costsDestructiveUpdate to true |
| `costsDestructiveUpdate` | boolean   | No       | —       | Set true to destroy existing costs and replace them with the specified costs                                                                                                                                                                                                                                          |
| `description`            | string    | No       | —       | Updated description for the program                                                                                                                                                                                                                                                                                   |
| `endDate`                | string    | No       | —       | End date of the program. Applicable to event, email, and webinar type programs                                                                                                                                                                                                                                        |
| `name`                   | string    | No       | —       | Name of the program                                                                                                                                                                                                                                                                                                   |
| `startDate`              | string    | No       | —       | Start date of program. Applicable to event, email and webinar type programs                                                                                                                                                                                                                                           |
| `tags`                   | object\[] | No       | —       | List of associated program tags                                                                                                                                                                                                                                                                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "The id value"
      },
      "costs": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "cost": {
              "type": "integer",
              "format": "int32",
              "description": "Amount of the cost"
            },
            "note": {
              "type": "string",
              "description": "Notes on the cost"
            },
            "startDate": {
              "type": "string",
              "format": "date-time",
              "description": "Start date of the period cost"
            }
          },
          "required": [
            "cost",
            "startDate"
          ]
        },
        "description": "Lists of associated period costs that allow you to append, replace, or delete. To append new costs, simply add them to costs array. To replace costs (destructive update), pass new costs and set costsDestructiveUpdate to true. To delete costs, do not pass costs parameter and set costsDestructiveUpdate to true"
      },
      "costsDestructiveUpdate": {
        "type": "boolean",
        "description": "Set true to destroy existing costs and replace them with the specified costs"
      },
      "description": {
        "type": "string",
        "description": "Updated description for the program"
      },
      "endDate": {
        "type": "string",
        "description": "End date of the program. Applicable to event, email, and webinar type programs"
      },
      "name": {
        "type": "string",
        "description": "Name of the program"
      },
      "startDate": {
        "type": "string",
        "description": "Start date of program. Applicable to event, email and webinar type programs"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "tagType": {
              "type": "string",
              "description": "Type of program tag"
            },
            "tagValue": {
              "type": "string",
              "description": "Value of the tag"
            }
          }
        },
        "description": "List of associated program tags"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## marketo-programs\_update\_smart\_campaign

Update Smart Campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description                       |
| ------------- | ------- | -------- | ------- | --------------------------------- |
| `id`          | integer | Yes      | —       | Id for the smart campaign         |
| `description` | string  | No       | —       | Description of the smart campaign |
| `name`        | string  | No       | —       | Name of the smart campaign        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Id for the smart campaign"
      },
      "description": {
        "type": "string",
        "description": "Description of the smart campaign"
      },
      "name": {
        "type": "string",
        "description": "Name of the smart campaign"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>