---
title: "Create Lead Group"
method: POST
path: "/leads/group/participants"
tags: ["Lead Group"]
---

# Create Lead Group

`POST /leads/group/participants`

Creates a group with the given Leads. If any Leads are already in a group, they will be removed from their existing group and added to the new group.

## Headers

- `x-api-key` string, required

## Request body

- RequestLeadGroup — Data to Create or Update a group
  - `group_participants` LeadGroupParticipant[] — List of Lead Group Participants in the request
    - `group_participant_lead_id` integer — Lead Id of the group participant to be added
    - `group_role_id` integer — Group Participant Type for the lead

## Response `200`

Returns the Group data of the newly created Group.

- ResponseGroup
  - `client_group` ClientGroup — All clients in a group
    - `group_id` integer — Id of the Group
    - `group_participants` GroupParticipants[] — List of participants and the role in the group
      - `group_participant_client_id` integer — The Client Id of the Group Participant
      - `group_participant_name` string — Name of the Client in the Group
      - `group_role_id` integer — Participant Type of the Client in the Group (Id)
      - `group_role` string — Participant Type of the Client in the Group

---

[API](https://skmtc.dev/wodify/apis/leads.md) · [All operations](https://skmtc.dev/wodify/apis/leads/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wodify/leads/revisions/974500ca0714/schema)