MYmyclickfunnels
Communities::Bans::UnbanAction

Create Ban Unban Action

Changed on

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.

post/communities/{community_id}/bans/unban_actions

Request

Path parameters

community_idstring required

Request body

Example request

{
  "communities_bans_unban_action": {
    "communities_bans_unban_action": {
      "target_all": false,
      "target_ids": [
        "MnOpQr",
        "StUvWx"
      ]
    }
  }
}

Response

Created

idinteger

Action ID

public_idstring nullable

Action public ID

community_idinteger

ID of the Community this action belongs to

target_allboolean

When true the action targets all eligible records in the community rather than the explicit target_ids list

target_idsinteger[]

Integer IDs of the targeted records (memberships or bans)

failed_idsinteger[]

Integer IDs of records that could not be processed

target_countinteger nullable

Total number of records that will be processed

performed_countinteger nullable

Number of records processed so far

started_atstring date-time nullable

Timestamp when the background job began processing

completed_atstring date-time nullable

Timestamp when the background job finished

created_atstring date-time

Created at

updated_atstring date-time

Updated at

status'queued' | 'processing' | 'completed'

Current status of the async action. Progresses: queued → processing → completed.

Changes

  • 511d88b30aeaRevision changes
    • info

      for the path request parameter community_id, the type was generalized from integer to string

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status