> ## 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 extensions and attach them to Google Ads entities at account, campaign, or ad group level

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

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

## Inputs

| Field             | Type                                                              | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ----------------- | ----------------------------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`         | GadsAccountItem or object or array of object or string or integer | Yes      | -       | Select the Google 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                                                                                                                                                                                                                                                                                                                                                                                                       |
| `ad_group_ids`    | array of string or SelectItem                                     | No       | -       | Select one or more ad groups to attach the sitelink                                                                                                                                                                                                                                                                                                                                                                                                       |
| `link_text`       | string                                                            | No       | -       | The clickable text for the sitelink (max 25 characters)                                                                                                                                                                                                                                                                                                                                                                                                   |
| `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)                                                                                                                                                                                                                                                                                                                                                                                                      |
| `description2`    | string                                                            | No       | -       | Second description line (optional, max 35 characters)                                                                                                                                                                                                                                                                                                                                                                                                     |
| `status`          | string or SelectableOption                                        | No       | -       | Status of the sitelink asset. Available options: 'ENABLED', 'PAUSED'. Default: ENABLED                                                                                                                                                                                                                                                                                                                                                                    |
| `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', 'status' (ENABLED/PAUSED, defaults to ENABLED), '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). |

### GadsAccountItem

| Field       | Type   | Required | Default | Description                                                                                                                                                    |
| ----------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `value`     | string | Yes      | -       |                                                                                                                                                                |
| `label`     | string | Yes      | -       |                                                                                                                                                                |
| `managerId` | string | Yes      | -       | The manager ID for the Google Ads account. Ask  user to use the dropdown to select accounts, this manager id is selected background and not shown to the user. |

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