---
title: "Create Ban Unban Action"
method: POST
path: "/communities/{community_id}/bans/unban_actions"
tags: ["Communities::Bans::UnbanAction"]
---

# Create Ban Unban Action

`POST /communities/{community_id}/bans/unban_actions`

Enqueue an async background job to unban one or more contacts from a community. The action record is returned immediately with `status: queued`. Poll `GET /communities/bans/unban_actions/{id}` until `status` is `completed`.

## Path parameters

- `community_id` integer, required

## Request body

- object
  - `communities_bans_unban_action` CommunitiesBansUnbanActionParameters — Communities::Bans::UnbanAction
    - `target_all` boolean — When true, unban all banned contacts in the community (target_ids is ignored)
    - `target_ids` string[] — Array of ban public IDs to unban. Required when target_all is false.

## Response `201`

Created

- CommunitiesBansUnbanActionAttributes — Base response shape shared by all community async bulk-action resources. The `status` field progresses from `queued` → `processing` → `completed`. Poll the `show` endpoint until `status` is `completed` or `performed_count` equals `target_count`.
  - `id` integer — Action ID
  - `public_id` string, nullable — Action public ID
  - `community_id` integer — ID of the Community this action belongs to
  - `target_all` boolean — When true the action targets all eligible records in the community rather than the explicit target_ids list
  - `target_ids` integer[] — Integer IDs of the targeted records (memberships or bans)
  - `failed_ids` integer[] — Integer IDs of records that could not be processed
  - `target_count` integer, nullable — Total number of records that will be processed
  - `performed_count` integer, nullable — Number of records processed so far
  - `started_at` string, date-time, nullable — Timestamp when the background job began processing
  - `completed_at` string, date-time, nullable — Timestamp when the background job finished
  - `created_at` string, date-time — Created at
  - `updated_at` string, date-time — Updated at
  - `status` 'queued' | 'processing' | 'completed' — Current status of the async action. Progresses: queued → processing → completed.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/myclickfunnels/apis/clickfunnels-api.md) · [All operations](https://skmtc.net/myclickfunnels/apis/clickfunnels-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myclickfunnels/clickfunnels-api/revisions/ae6313eaa176/schema)