---
title: "Create Ban"
method: POST
path: "/communities/{community_id}/bans"
tags: ["Communities::Ban"]
---

# Create Ban

`POST /communities/{community_id}/bans`

Ban a contact from a community

## Path parameters

- `community_id` integer, required

## Request body

- object
  - `communities_ban` CommunitiesBanParameters — Communities::Ban
    - `contact_id` string, required — Public ID of the Contact to ban
    - `reason` string, nullable — Optional reason for the ban (max 1024 characters)

## Response `201`

Created

- CommunitiesBanAttributes — Communities::Ban
  - `id` integer — Ban ID
  - `public_id` string, nullable — Ban public ID
  - `community_id` integer — ID of the Community this ban applies to
  - `bannable_type` string — Polymorphic type of the bannable scope (e.g. Community)
  - `bannable_id` integer — Polymorphic ID of the bannable scope
  - `banned_by_id` integer — ID of the membership record that issued the ban (set automatically)
  - `reason` string, nullable — Optional reason for the ban (max 1024 characters)
  - `created_at` string, date-time — Created at
  - `updated_at` string, date-time — Updated at
  - `contact` object, nullable — The banned Contact (null if the contact has been removed)
    - `id` integer — Contact ID
    - `public_id` string, nullable — Contact public ID
    - `email_address` string, nullable — Contact email address
    - `first_name` string, nullable — Contact first name
    - `last_name` string, nullable — Contact last name
    - `phone_number` string, nullable — Contact phone number

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity

---

[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)