> ## Documentation Index
> Fetch the complete documentation index at: https://developer.peoplewisher.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Celebration Group

> Delete a Celebration Group from your Peoplewisher account.

<RequestExample>
  ```bash cURL theme={null}
  curl --request DELETE \
    --url 'https://api.peoplewisher.com/v1/celebration-groups/24' \
    --header 'Authorization: Bearer YOUR_API_KEY' 
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true
  }
  ```
</ResponseExample>

## How it works

Deleting a group removes that group from the account. Review the contacts assigned to the group before deleting it if those contacts are still expected to participate in a Peoplewisher workflow.

## Authentication

Include your Peoplewisher API key as a Bearer token on every request:

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

Your API key is available in **Peoplewisher → Settings → API**. Keep it private and never expose it in browser-side code or public repositories.


## OpenAPI

````yaml openapi.yaml DELETE /celebration-groups/{group_id}
openapi: 3.0.3
info:
  title: Peoplewisher API
  version: 1.0.0
  description: |
    The Peoplewisher API lets an application synchronize contacts and place
    those contacts into Peoplewisher Celebration Groups. Peoplewisher then
    runs the celebration workflows configured for those groups in the
    Peoplewisher application.

    The public API is intentionally focused: applications provide people data
    and group membership. Templates, channels, schedules, celebration
    settings, and workflow behavior are managed in the Peoplewisher UI.
servers:
  - url: https://api.peoplewisher.com/v1
    description: Peoplewisher API
security:
  - bearerAuth: []
tags:
  - name: Contacts
    description: Manage the people whose celebrations Peoplewisher handles.
  - name: Celebration Groups
    description: >-
      Manage the Peoplewisher groups that determine which celebration workflow
      applies to a contact.
paths:
  /celebration-groups/{group_id}:
    delete:
      tags:
        - Celebration Groups
      summary: Delete a Celebration Group
      description: |
        Removes a Celebration Group from the active group list.

        PeopleWisher's existing group deletion flow marks the group for
        deletion rather than immediately deleting all related records.
      operationId: deleteCelebrationGroup
      parameters:
        - $ref: '#/components/parameters/GroupIdPath'
      responses:
        '200':
          description: Celebration Group deletion accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
              example:
                success: true
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-codeSamples:
        - lang: curl
          source: |-
            curl --request DELETE \
              --url 'https://api.peoplewisher.com/v1/celebration-groups/24' \
              --header 'Authorization: Bearer YOUR_API_KEY' 
components:
  parameters:
    GroupIdPath:
      name: group_id
      in: path
      required: true
      description: Peoplewisher Celebration Group ID.
      schema:
        type: integer
        minimum: 1
  schemas:
    SuccessResponse:
      type: object
      properties:
        success:
          type: boolean
    ErrorResponse:
      type: object
      required:
        - success
        - error
        - message
      properties:
        success:
          type: boolean
        error:
          type: string
        message:
          type: string
        request_id:
          type: string
          nullable: true
  responses:
    NotFound:
      description: The requested resource does not exist in the authenticated account.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error: not_found
            message: Contact not found.
    RateLimited:
      description: The API request was rate limited.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            error: rate_limited
            message: Too many requests. Please retry later.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: |
        Use the API key generated in Peoplewisher Settings as a Bearer token.

````