---
title: "Refresh"
method: POST
path: "/social_accounts/{id}/refresh"
tags: ["Social Accounts"]
---

# Refresh

`POST /social_accounts/{id}/refresh`

Refreshes the state of a social account. Use it to clear an `error` that has been resolved.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `account_id` string — The Account (biz_ identifier) the social account is connected to. An account-scoped API key may omit this to default to its own account.

## Response `200`

refresh started

- SocialAccount
  - `error` string, nullable, required — Why this social account currently can't be used for advertising — a failed share or a Meta-side restriction. Null when the account is healthy.
  - `external_id` string, nullable, required — The platform-specific ID for this social account.
  - `id` string, required — Unique identifier for the social account.
  - `name` string, nullable, required — The display name of the social account on the platform.
  - `parent_social_account` SocialAccountParent, required
    - `external_id` string, nullable, required — The platform-specific ID for the parent social account.
    - `id` string, required — Social account ID, prefixed `sacc_`.
    - `name` string, nullable, required — The display name of the parent social account on the platform.
    - `platform` 'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram' | 'linkedin', required — The platform the parent social account exists on.
    - `profile_picture_url` string, nullable, required — The URL where the profile picture of the parent social account can be accessed.
    - `username` string, nullable, required — The username of the parent social account on the platform.
    - `verified` boolean, required — Whether the parent social account is verified on the platform.
  - `platform` 'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram' | 'linkedin', required — The platform the social account exists on.
  - `profile_picture_url` string, nullable, required — The URL where the profile picture of the social account can be accessed.
  - `scopes` string[], required
  - `url` string, nullable, required — The URL where the social account can be accessed on the platform. Null while a Whop-owned account is still being provisioned.
  - `username` string, nullable, required — The username of the social account on the platform. Null while a Whop-owned account is still being provisioned.
  - `verified` boolean, required — Whether the social account is verified on the platform.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found
- `409` — Conflict
- `429` — Too Many Requests

## Changes

> 70 revisions in range; 1 not diffed.

- **2026-09-24** `7fcefabddb0a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/social_accounts/:id/refresh/post.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/7fcefabddb0a?raw)