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

# Update Ad

> Advanced: partially updates a Snapchat ad (name, status, schedule, tracking URLs) from a raw field payload; only provided fields change

Advanced: partially updates a Snapchat ad (name, status, schedule, tracking URLs) from a raw field payload; only provided fields change. Prefer the dedicated status and rename operations for simple changes.

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

## Inputs

| Field            | Type                 | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------- | -------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`        | DynamicAccount       | Yes      | -       | Select the Snapchat Ads account that owns the ad.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ad_id`          | string or SelectItem | Yes      | -       | Snapchat ad ID to update. Do not repeat it inside update\_payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `update_payload` | object or string     | Yes      | -       | Ad fields to update as a JSON object; only the fields you include are changed (each key becomes a JSON-Patch add operation, and a null value removes an optional attribute). Editable fields per the Snapchat docs: name, status (ACTIVE/PAUSED), start\_time, end\_time (ISO 8601), third\_party\_paid\_impression\_tracking\_urls, and third\_party\_on\_swipe\_tracking\_urls (lists of https URLs from approved domains). creative\_id is NOT editable on an ad: to change the creative content (headline, CTA, attachment URL), use snapchat\_ads\_update\_creative on the ad's creative, which affects all ads using it and triggers re-review; to show entirely different content, create a new creative and a new ad instead. Prefer the dedicated operations for plain changes: snapchat\_ads\_update\_ad\_status and snapchat\_ads\_rename\_ad. Example: \{"end\_time": "2026-09-30T00:00:00Z"} |
| `dry_run`        | boolean              | No       | `False` | When true, do not call Snapchat. Return the resolved JSON-Patch operations for review.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

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

## Output

**Type**: `Dict`

Returns the updated fields and patch operations applied.

**Fields**: `ad_id`, `updated_fields`, `operations`, `dry_run`