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

# Create Sitelinks

> Create sitelink ad extensions and attach them to Microsoft Ads entities at account, campaign, or ad group level

Create sitelink ad extensions and attach them to Microsoft Ads entities at account, campaign, or ad group level

|                       |                                  |
| --------------------- | -------------------------------- |
| **App**               | Microsoft Ads                    |
| **Operation ID**      | `microsoft_ads_create_sitelinks` |
| **Type**              | Action                           |
| **Connection**        | `microsoft_ads` (required)       |
| **Credits per run**   | 1                                |
| **Agent / MCP tool**  | Yes                              |
| **Requires approval** | Yes (write operation)            |

## Inputs

| Field             | Type                                                                      | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------- | ------------------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`         | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes      | -       | Select the Microsoft Ads account, ask user for it if not provided                                                                                                                                                                                                                                                                                                                                                                     |
| `update_type`     | string or SelectableOption                                                | Yes      | -       | Choose whether to create a single sitelink or multiple sitelinks at once. Available options: 'single' (Single Sitelink), 'bulk' (Multiple Sitelinks)                                                                                                                                                                                                                                                                                  |
| `level`           | string or SelectableOption                                                | No       | -       | Choose where to attach the sitelink. Required for 'single' mode. Available options: 'ACCOUNT', 'CAMPAIGN', 'AD\_GROUP'                                                                                                                                                                                                                                                                                                                |
| `campaign_ids`    | array of string or SelectItem                                             | No       | -       | Select one or more campaigns to attach the sitelink (CAMPAIGN level)                                                                                                                                                                                                                                                                                                                                                                  |
| `ad_group_ids`    | array of string or SelectItem                                             | No       | -       | Select one or more ad groups to attach the sitelink (AD\_GROUP level)                                                                                                                                                                                                                                                                                                                                                                 |
| `link_text`       | string                                                                    | No       | -       | The clickable text for the sitelink (max 25 characters with a description, otherwise max 35)                                                                                                                                                                                                                                                                                                                                          |
| `final_url`       | string                                                                    | No       | -       | Landing page URL for the sitelink (e.g., `https://example.com`)                                                                                                                                                                                                                                                                                                                                                                       |
| `description1`    | string                                                                    | No       | -       | First description line (optional, max 35 characters). If set, description2 is required.                                                                                                                                                                                                                                                                                                                                               |
| `description2`    | string                                                                    | No       | -       | Second description line (optional, max 35 characters). If set, description1 is required.                                                                                                                                                                                                                                                                                                                                              |
| `start_date`      | integer or string                                                         | No       | -       | Start date for when the sitelink can begin serving (Unix timestamp or YYYY-MM-DD format)                                                                                                                                                                                                                                                                                                                                              |
| `end_date`        | integer or string                                                         | No       | -       | End date for when the sitelink stops serving (Unix timestamp or YYYY-MM-DD format)                                                                                                                                                                                                                                                                                                                                                    |
| `structured_data` | array (also accepts a comma-separated string)                             | No       | -       | Use only when update\_type is 'bulk'. CSV/JSON data with required columns: 'level' (ACCOUNT/CAMPAIGN/AD\_GROUP), 'link\_text', 'final\_url'. Optional columns: 'description1', 'description2' (must be provided together), 'start\_date', 'end\_date' (YYYY-MM-DD or Unix timestamp). For CAMPAIGN level add 'campaign\_ids' (comma-separated for multiple), for AD\_GROUP level add 'ad\_group\_ids' (comma-separated for multiple). |

### MicrosoftAdsAccountItem

| Field        | Type   | Required | Default | Description                                                                                                     |
| ------------ | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------- |
| `value`      | string | Yes      | -       |                                                                                                                 |
| `label`      | string | Yes      | -       |                                                                                                                 |
| `customerId` | string | No       | -       | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns created sitelinks details.

**Fields**: `sitelink_ids`, `sitelinks_created`