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

# Get Account History

> Retrieves historical account activity and changes for Spotify Ads accounts: who changed what and when, with before and after values

Retrieves historical account activity and changes for Spotify Ads accounts: who changed what and when, with before and after values. Spotify keeps 180 days of history.

|                      |                                   |
| -------------------- | --------------------------------- |
| **App**              | Spotify Ads                       |
| **Operation ID**     | `spotify_ads_get_account_history` |
| **Type**             | Action                            |
| **Connection**       | `spotify_ads` (required)          |
| **Credits per run**  | 1                                 |
| **Agent / MCP tool** | Yes                               |

## Inputs

| Field             | Type                                                                                    | Required | Default | Description                                                                                                                                                                                                                                            |
| ----------------- | --------------------------------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `accounts`        | array (also accepts a comma-separated string)                                           | Yes      | -       | Select Spotify Ads accounts to retrieve history for                                                                                                                                                                                                    |
| `time_range`      | string or SelectableOption                                                              | No       | -       | Select time period for the account history. Available options: 'last\_30\_days' (Last 30 days), 'last\_14\_days' (Last 14 days), 'last\_7\_days' (Last 7 days), 'today' (Today only), 'yesterday' (Yesterday only). Spotify keeps 180 days of history. |
| `entity_type`     | enum (`CAMPAIGN`, `AD_SET`, `AD_ACCOUNT`, `BUSINESS`, `CREATIVE`)                       | No       | -       | Only return changes to this kind of entity: CAMPAIGN, AD\_SET, AD\_ACCOUNT, BUSINESS, or CREATIVE.                                                                                                                                                     |
| `entity_ids`      | string or array of string                                                               | No       | -       | Only return changes to these entity ids. Accepts a list or a comma-separated string.                                                                                                                                                                   |
| `entity_name`     | string                                                                                  | No       | -       | Only return changes to entities whose name contains this text.                                                                                                                                                                                         |
| `change_category` | enum (`STATUS`, `BUDGET`, `TARGETING`, `CREATIVE`, `SCHEDULING`, `SETTINGS`, `BILLING`) | No       | -       | Only return changes in this category: STATUS, BUDGET, TARGETING, CREATIVE, SCHEDULING, SETTINGS, or BILLING.                                                                                                                                           |
| `principal_type`  | enum (`USER`, `SERVICE`)                                                                | No       | -       | Only return changes made by a USER or by a SERVICE (API integration).                                                                                                                                                                                  |
| `limit`           | integer                                                                                 | No       | `100`   | Maximum number of history records to return. Default: 100.                                                                                                                                                                                             |

### SelectableOption

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

## Output

**Type**: `List[Dict]`

Returns account activity history with the entity changed, the operation, the actor, and each field's before and after values.

**Fields**: dynamic (depend on the inputs)