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

# Manage Reporting Annotations

> Adds, edits or deletes Google Analytics 4 report annotations (campaign launches, site changes, incidents) with a title, color and a single date or date range, so they show on report timelines

Adds, edits or deletes Google Analytics 4 report annotations (campaign launches, site changes, incidents) with a title, color and a single date or date range, so they show on report timelines.

| | |
| - | - |
| **App** | GA4 |
| **Operation ID** | `ga4_manage_reporting_annotations` |
| **Type** | Action |
| **Connection** | `ga4` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Requires approval** | Yes (write operation) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | array (also accepts a comma-separated string) | No | - | The GA4 property to change. Only one property at a time. |
| `action` | string or SelectableOption | Yes | - | 'create' adds an annotation shown on report timelines (campaign launch, site change, outage); 'update' edits its title, description, color or dates; 'delete' removes it. Options: 'create', 'update', 'delete'. |
| `annotation_id` | string | No | - | Numeric id of the annotation to update or delete. Read ids from ga4\_get\_property\_settings with setting 'reporting\_annotations'. |
| `title` | string | No | - | Annotation title shown on the chart. Required on create. |
| `description` | string | No | - | Optional longer note. |
| `color` | string or SelectableOption | No | - | Marker color: 'PURPLE', 'BROWN', 'BLUE', 'GREEN', 'RED', 'CYAN' or 'ORANGE'. Defaults to 'BLUE' on create. |
| `annotation_date` | integer or string | No | - | Single date the annotation applies to, YYYY-MM-DD. Use either this or start\_date plus end\_date. Required on create. |
| `start_date` | integer or string | No | - | Range start, YYYY-MM-DD, used with end\_date instead of annotation\_date. |
| `end_date` | integer or string | No | - | Range end, YYYY-MM-DD, inclusive. |

### SelectableOption

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

## Output

**Type**: `Dict`

Returns the saved annotation: id, title, description, color and its date or date range.

**Fields**: `property_id`, `status`, `annotation_id`, `title`, `description`, `color`, `system_generated`, `annotation_date`, `start_date`, `end_date`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.