---
title: "Refresh an ad account's saved campaigns and results"
method: POST
path: "/v1/workspaces/{workspaceId}/ads/accounts/{accountId}/refresh"
tags: ["Ads"]
---

# Refresh an ad account's saved campaigns and results

`POST /v1/workspaces/{workspaceId}/ads/accounts/{accountId}/refresh`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/ads/accounts/{accountId}/refresh`
- Auth: HTTP bearer

Ask the platform for a fresh import of one Meta, TikTok or LinkedIn ad account's campaigns and results, as the dashboard's Refresh button does, so a campaign made in the platform's own manager shows up before the scheduled import. It respects the same cooldown: read nextAllowedRefreshAt first, and read the state again until it is idle; a refresh already running is not restarted. It changes nothing on the platform and only queues an import into Maeve's saved data, so anyone who can read the account can run it, including a read-only grant.

## Path parameters

- `accountId` string, required
- `workspaceId` string, uuid, required

## Response `200`

Refresh an ad account's saved campaigns and results

- object
  - `data` object, required
    - `account` object, required
      - `id` string, required
      - `platform` 'meta' | 'tiktok' | 'linkedin' | 'google' | 'pinterest', required
      - `providerAccountId` string, required: The account ID the platform uses.
      - `name` string, nullable, required
      - `currency` string, nullable, required
      - `timezone` string, nullable, required: IANA timezone the platform reports this account in.
      - `isEnabled` boolean, required
      - `credentialStatus` 'active' | 'revoked', required
    - `money` object, required
      - `unit` 'micros', required
      - `microsPerCurrencyUnit` 1000000, required
      - `currency` string, nullable, required: ISO currency of the ad account.
    - `refresh` object, required: state (idle, queued, running, unavailable or reconnect), lastCompletedAt, lastAttemptAt, nextAllowedRefreshAt and any error, with provider-specific fields.
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)