Create a Group

Download skillThe skill is a reference md and part of wix-manage skill. You can use the following command to add the full wix-manage skill to your project:
Copy

Role

You help the site owner create a group in Wix Groups. Ask only one question per message. Work with names only: never show ids to the user.

Every call below is a site call: make it with site scope and the site ID in the tool's site ID parameter. Use only the Create a group script in this recipe to check the app, find the creator and create the group. Run it as written and as its own call, fill in only its inputs, and follow the note it returns: it says what to tell or ask the user next, and when to end your turn. When it returns a question, end your reply with that question, word for word. The script has every endpoint, body and response path it needs: do not search the docs or read the method schemas before running it.

Call (made by the script)Purpose
GET https://www.wixapis.com/apps-installer-service/v1/app-instancescheck that Wix Groups is installed
GET https://www.wixapis.com/roles-management/v2/contributors/queryread the site owner's user id (accountOwnerId)
GET https://www.wixapis.com/members/v1/members/{id}read the site owner's member record, and the creator Wix set
POST https://www.wixapis.com/members/v1/members/queryfind the member the user named, or list up to 10 members to choose from
POST https://www.wixapis.com/social-groups-proxy/groups/v2/groupscreate the group

Docs: Create Group, Find and Manage Site Members, Manage Site Collaborators, List Installed Apps, Install Wix Apps.

Steps

To create a group, next flow should be followed excatly:

  1. check if Wix Groups app is installed, if not, ask the user if they wish to install it.
  2. Select a Group Name: The Agent should suggest a name based on the knowledge about user.
  3. Select a Group Description: The Agent should suggest a description based on the knowledge about user and the group name.
  4. Select a Group Privacy: Select whether the group will be public, private, or secret (hidden).
  5. Choose the group's creator (see Choose the creator).
  6. Create a Group.

After the group is created, user can start inviting members and customizing the group settings.

When the user's request already gives a name, a description or a privacy option, accept it and skip that step's suggestions.

Run the Create a group script at the start, with whatever the user's request already gives and the rest left empty, and again each time the user answers. It goes through the steps in this order and stops at the first one that still needs the user: its note names that step.

Check that Wix Groups is installed

The script checks it. Wix Groups is installed when an entry in appInstances[] has appDefId 148c2287-c669-d849-d153-463c7486a694. If it is not, tell the user that Wix Groups is not installed on the site and ask if they wish to install it; end your turn on that question. Install it only after the user says yes (Install Wix Apps), then run the script again. Consent to create a group is not consent to install an app: a request that says to go ahead without asking does not cover installing Wix Groups, so ask even then.

Select a group name

Goal: Suggest personalized group names and let user select one.

  1. Suggest 4 unique, non-offensive names: Ensure at least one name includes an emoji.
  2. Show them as a numbered list in your message.
  3. Ask for user feedback: With displaying the names, ask: "Do you like any of the suggested names for your group? Please choose one from the list below or share your own idea if you have something specific in mind."
  4. Accept the chosen or provided name: Only when the user provides or selects a group name, accept it and move on without suggesting names again.

No future tense or greetings: Present actions as if they are already happening.

Select a group description

Goal: Suggest personalized group descriptions and let user select one.

  1. Once the group name is chosen, suggest 2-3 unique descriptions.
  2. Each description must be 3 to 5 sentences, 250 to 500 characters total.
  3. Show them as a numbered list in your message.
  4. With the list, say: "Do you like any of the suggested description for your group? Please choose one from the list below or share your own idea if you have something specific in mind."
  5. If the user provides feedback or wants different descriptions, repeat the process.

Select a group privacy

Goal: Suggest available privacy options to the user and let the user select one.

  1. When it's time to choose privacy, prompt the user with the exact message "Please choose a privacy option for your group" and show these options as a numbered list:
    1. Public: Anyone can see the group and its posts, and anyone can join.
    2. Private: Anyone can find the group, but only members can see its posts. People ask to join.
    3. Hidden: Only members can see the group. People join only when they are added or invited.
  2. The script sends the choice as privacyStatus: Public is PUBLIC, Private is PRIVATE, Hidden (secret) is SECRET.

Choose the creator

Every group has a creator: a site member who becomes the group's owner and admin. The script always sends that member's id as creatorId in the create call. When the call is made with an API key, Wix rejects a create without it (400, "Group's createdBy.id can't be empty").

  • The user names a member (by name or email): the script queries the site members with a filter on loginEmail, profile.nickname, or contact.firstName and contact.lastName, as in Find and Manage Site Members (Step 2), and keeps the members whose email, nickname or full name equals what the user said, ignoring case. The filter ignores case too. A member created or renamed in the last minutes can be missing from filters, so when the filter finds no one the script also checks the 100 newest members in code. If several members match, ask the user to pick; if none match, say so and ask who should create the group.

  • The user names no one: the creator is the site owner's own member record. Query Site Contributors returns the owner's user id as accountOwnerId (Manage Site Collaborators, step 2):

    Copy

    When the owner has a member record on the site, that member's id is the owner's user id, so the script reads it with GET https://www.wixapis.com/members/v1/members/<accountOwnerId>?fieldsets=FULL; a 404 means the owner has no member record. If it finds that member, it uses it, and the confirmation names that member as the creator. If not, ask the user which site member should create the group, showing up to 10 member names as a numbered list. Consent to create a group is not consent to choose its creator: a request that says to go ahead without asking does not cover picking a member, so ask even then.

Never create a site member to use as the creator.

Confirming the creation

Ask the user to confirm before creating the group, even when the request is clear. Say exactly what will be created (name, privacy and creator) and end your turn: your final message must end with the question ("Create the public group Trail Runners, with Dana Levi as its creator?"), and the code you run this turn must not contain the create call. Make the call only in a later turn, after the user says yes. Treat the request as already confirmed only when it carries explicit consent on top of the instruction, such as "yes", "go ahead" or "no need to confirm", and names the group; then make the call without asking. That consent covers only the create call: it does not cover installing Wix Groups or choosing the creator.

The script does this for you: run it with userConfirmed = false and it creates nothing and returns the question to end your reply with. Run it with userConfirmed = true only after the user says yes, or when the request already carries explicit consent as above.

Create the group

Goal: Create the group using the chosen name, description, and privacy option.

  1. Once the group name, description, privacy option and creator are selected, the script creates the group with these details:

    Copy
  2. Do not mention the call or any implementation details to the user.

  3. The script reads the result from the response, not from what it sent, and its note says what to report:

    • group with an id: the group exists. Its creator is the member in group.ownerId; name that member. When the call runs as a signed-in Wix user, Wix makes that user the creator, so ownerId can differ from creatorId: report the member Wix set. If that member is not the one the user asked for, say so: Wix made the signed-in user the group's creator.
    • A response without group.id: tell the user the group was not created and explain what the response says. The site's Group Creation setting (Groups > General Settings in the dashboard) can require a site admin's approval for groups that members create.
    • 403 (PERMISSION_DENIED): explain that they cannot create a group on this site, and stop.
    • Any other error: explain it plainly.
  4. After the group is successfully created, inform the user that their group has been created without mentioning the internal steps or tools used. For example: "Your group has been created successfully! You can now start inviting members and customizing the group settings."

Create a group script

Fill in only the inputs: what the user's request or answers gave, and an empty string for the rest. Set creator only when the user named the member who should create the group; leave it empty otherwise. After the user picks a member from a list the script returned, set creator to the name or email the user chose.

Copy

Last updated: 16 November 2026

Did this help?