---
title: "Turn the social plan on"
method: POST
path: "/v1/social/plan"
tags: ["Profiles"]
---

# Turn the social plan on

`POST /v1/social/plan`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/social/plan`
- Auth: HTTP bearer

Turns the monthly social networks plan on: charges `monthly_credits` (one period for the clients billable now — nothing while every client is inside its free first month) once from your balance (a SUBSCRIPTION row in the ledger) and opens publishing, connecting, comments, messages and statistics for `period_days`. Needs `confirm: true`. Already on → nothing is charged. Short of credits → 402. Turn renewal off on the Social page.

**Billing:** The plan's monthly credits, once (shown in charged_credits) · **Rate limit:** 10/min

## Headers

- `Idempotency-Key` string
- `X-Tag` string

## Request body

- object
  - `confirm` true, required: Must be true: you agree to the monthly charge

## Response `200`

Completed

- object
  - `id` string: Execution id — stable across internal retries; use it with GET /v1/executions/{id}
  - `status` 'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
  - `operation` string
  - `tag` string, nullable: Your X-Tag, if sent
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `output` object: Operation result (see each operation). While a Studio render is processing: `stage` (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), `phase` (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), `progress` (a percent, 0–100) and `progress_fraction` (0–1), `eta_seconds` (seconds left, never below 0) and `estimate_seconds`
    - `active` boolean
    - `clients` integer: Clients: brands with a connected account (the accounts in no brand are one client)
    - `accounts` integer: Social accounts connected
    - `auto_renew` boolean
    - `free_until` string, date-time, nullable: When the soonest of those free months ends
    - `price_list` object[], nullable
      - `to_clients` integer, nullable
      - `from_clients` integer
      - `credits_per_client` number
    - `next_client` object
      - `allowed` boolean
      - `monthly_credits` number: A period with one more billable client
      - `per_client_credits` number, nullable
    - `period_days` number
    - `active_until` string, date-time, nullable
    - `free_clients` integer: Clients inside their free first month now
    - `max_accounts` integer
    - `next_account` object: Earlier name of next_client (charge_now_credits is always 0)
      - `allowed` boolean
      - `monthly_credits` number
      - `charge_now_credits` number
      - `per_account_credits` number, nullable
    - `billed_clients` integer, nullable: How many clients the current period has paid for
    - `billed_accounts` integer, nullable: Earlier name of billed_clients
    - `charged_credits` number: POST only: what this call charged (0 when the plan was already on)
    - `how_to_activate` string, nullable
    - `monthly_credits` number: What one period costs at the clients billable now (a client = a brand with a connected account; one inside its free first month is not counted; none billable: 0): what turning the plan on, or its next renewal, charges
    - `billable_clients` integer: Clients past their free first month: what the price counts
    - `first_month_free` boolean: The plan is off and turning it on charges nothing now: the first client's first month is free, then per_client_credits a month
    - `available_credits` number
    - `per_client_credits` number, nullable: The price per client a month at this count (null: one flat price)
    - `accounts_per_client` integer: The most network accounts one client may hold
    - `per_account_credits` number, nullable: Earlier name of per_client_credits
    - `new_client_free_days` integer: A new client's free first days (once per network account; 0: none)
  - `error` string, nullable
  - `usage` object
    - `credits_charged` number, nullable
    - `credits_reserved` number
    - `estimated_credits` number
    - `cost_source` 'provider_reported' | 'calculated' | 'estimated' | 'null', nullable
    - `provider_usage` object, nullable: Normalised consumption, e.g. { VIDEO_SECOND: 22.4 }
  - `balance` object
    - `available` number
    - `reserved` number

## Other responses

- `400`: Invalid input
- `402`: Insufficient credits / project budget
- `404`: Resource not found (or not yours)
- `429`: Rate limited
- `503`: Service temporarily paused

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)