Zendesk

Zendesk Group Memberships API

The Group Memberships API from Zendesk — 6 operation(s) for group memberships.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/group_memberships List group memberships · Zendesk Get Api V2 Group_memberships #
Ask an LLM
“Which agents belong to which groups?”
“Can I page through every group membership in my account?”
Tell an agent
List all group memberships.
Show which agents are in which groups.
POST /api/v2/group_memberships Add an agent to a group · Zendesk Post Api V2 Group_memberships #
Ask an LLM
“Can I assign an agent to a support group?”
“Who is allowed to add agents to groups?”
Tell an agent
Add this agent to the Billing group.
Create a group membership for the new hire in Tier 1.
GET /api/v2/group_memberships/{group_membership_id} Get a group membership · Zendesk Get Api V2 Group_memberships Group_membership_id #
Ask an LLM
“Is a group membership id the same as a group id?”
“Can I look up one specific membership record?”
Tell an agent
Show this group membership.
Get the details of that membership record.
DELETE /api/v2/group_memberships/{group_membership_id} Remove an agent from a group · Zendesk Delete Api V2 Group_memberships Group_membership_id #
Ask an LLM
“What happens to an agent's tickets when they leave a group?”
“Can I take one agent out of a group immediately?”
Tell an agent destructive · confirm first
Remove this agent from the group.
Delete that group membership and unassign the agent's working tickets.
GET /api/v2/group_memberships/assignable List assignable group memberships · Zendesk Get Api V2 Group_memberships Assignable #
Ask an LLM
“Which group memberships can tickets actually be assigned to?”
“Can I list only memberships that are assignable?”
Tell an agent
List assignable group memberships.
Show memberships where tickets can be assigned.
POST /api/v2/group_memberships/create_many Add many agents to groups at once · Zendesk Post Api V2 Group_memberships Create_many #
Ask an LLM
“Can I assign up to 100 agents to groups in one request?”
“Does bulk adding agents to groups return a job status?”
Tell an agent
Add all of these agents to their groups in bulk.
Create group memberships for this batch of new agents.
DELETE /api/v2/group_memberships/destroy_many Remove many agents from groups · Zendesk Delete Api V2 Group_memberships Destroy_many #
Ask an LLM
“Can I remove several agents from groups in one call?”
“Are working tickets unassigned when memberships are removed in bulk?”
Tell an agent destructive · confirm first
Remove group memberships {ids}.
Bulk delete memberships {ids} and unassign their tickets.
PUT /api/v2/users/{user_id}/group_memberships/{group_membership_id}/make_default Set an agent's default group · Zendesk Put Api V2 Users User_id Group_memberships Group_membership_id… #
Ask an LLM
“Can I choose which group is an agent's default?”
“Where is an agent's primary group set?”
Tell an agent
Make this membership the agent's default group.
Set Billing as the default group for this agent.

Documentation

📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/introduction/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/targets/targets/
📖
Documentation
https://developer.zendesk.com/api-reference/sales-crm/resources/account/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/activity_stream/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/channel_framework/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket-attachments/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/audit_logs/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/automations/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/bookmarks/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/brand_agents/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/brands/
📖
Documentation
https://developer.zendesk.com/api-reference/live-chat/chat-api/chats/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_comments/
📖
Documentation
https://developer.zendesk.com/api-reference/custom-data/introduction/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/custom_roles/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/custom_ticket_statuses/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/users/users/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/deletion_schedules/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/dynamic_content/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/email_notifications/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/groups/group_memberships/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/group_sla_policies/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/groups/groups/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_import/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/incremental_exports/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/job_statuses/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/macros/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/oauth/oauth_tokens/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/organizations/organization_memberships/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/organizations/organization_subscriptions/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/push_notification_devices/
📖
Documentation
https://developer.zendesk.com/api-reference/agent-availability/omnichannel_routing_queues/omnichannel_routing_queues/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/support_addresses/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/lookup_relationships/lookup_relationships/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket-requests/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/resource_collections/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/skill_based_routing/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/satisfaction_ratings/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/satisfaction_reasons/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/search/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/account-configuration/sessions/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/sharing_agreements/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_skips/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/sla_policies/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/suspended_tickets/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/tags/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_audits/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_fields/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_form_statuses/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_forms/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_metrics/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/triggers/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/business-rules/views/
📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/workspaces/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/openapi/zendesk-group-memberships-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/json-schema/zendesk-ticket-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/json-schema/zendesk-user-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/json-ld/zendesk-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/zendesk-group-memberships-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zendesk-group-memberships-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Zendesk Group Memberships API
  version: '1.0'
  description: 'Operations tagged Group Memberships across 2 of this provider''s published API definitions: group-memberships-openapi-original.yml, users-openapi-original.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: Group Memberships
paths:
  /api/v2/group_memberships:
    get:
      operationId: ListGroupMemberships
      tags:
      - Group Memberships
      summary: Zendesk Get Api V2 Group_memberships
      description: '#### Pagination


        * Cursor pagination (recommended)

        * Offset pagination


        See Pagination.


        Returns a maximum of 100 records per page.


        #### Allowed For:


        * Agents'
      parameters:
      - $ref: '#/components/parameters/GroupId'
      - $ref: '#/components/parameters/UserId'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMembershipsResponse'
              examples:
                default:
                  $ref: '#/components/examples/GroupMembershipsResponseExample'
    post:
      operationId: CreateGroupMembership
      tags:
      - Group Memberships
      summary: Zendesk Post Api V2 Group_memberships
      description: 'Assigns an agent to a given group.


        #### Allowed For


        * Admins

        * Agents assigned to a custom role with permissions to manage group memberships (Enterprise only)'
      responses:
        '201':
          description: Created response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMembershipResponse'
              examples:
                default:
                  $ref: '#/components/examples/GroupMembershipResponseExample'
  /api/v2/group_memberships/{group_membership_id}:
    parameters:
    - $ref: '#/components/parameters/GroupMembershipId'
    - $ref: '#/components/parameters/UserId'
    get:
      operationId: ShowGroupMembershipById
      tags:
      - Group Memberships
      summary: Zendesk Get Api V2 Group_memberships Group_membership_id
      description: 'The ''id'' is the group membership id, not a group id.


        #### Allowed For


        * Agents'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMembershipResponse'
              examples:
                default:
                  $ref: '#/components/examples/GroupMembershipResponseExample'
    delete:
      operationId: DeleteGroupMembership
      tags:
      - Group Memberships
      summary: Zendesk Delete Api V2 Group_memberships Group_membership_id
      description: 'Immediately removes a user from a group and schedules a job to unassign all working tickets that are assigned to the given user and group combination.


        #### Allowed For


        * Admins

        * Agents assigned to a custom role with permissions to manage group memberships (Enterprise only)'
      responses:
        '204':
          description: No content response
  /api/v2/group_memberships/assignable:
    get:
      operationId: ListAssignableGroupMemberships
      tags:
      - Group Memberships
      summary: Zendesk Get Api V2 Group_memberships Assignable
      description: 'Returns a maximum of 100 group memberships per page.


        #### Pagination


        * Cursor pagination (recommended)

        * Offset pagination


        See Pagination.


        Returns a maximum of 100 records per page.


        #### Allowed For:


        * Agents'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMembershipsResponse'
              examples:
                default:
                  $ref: '#/components/examples/GroupMembershipsResponseExample'
  /api/v2/group_memberships/create_many:
    post:
      operationId: GroupMembershipBulkCreate
      tags:
      - Group Memberships
      summary: Zendesk Post Api V2 Group_memberships Create_many
      description: 'Assigns up to 100 agents to given groups.


        #### Allowed For


        * Admins

        * Agents assigned to a custom role with permissions to manage group memberships (Enterprise only)


        #### Response


        This endpoint returns a `job_status` JSON object and queues a background job to do the work. Use the Show Job Status endpoint to check for the job''s completion.'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
              examples:
                default:
                  $ref: '#/components/examples/JobStatusResponseExample'
  /api/v2/group_memberships/destroy_many:
    delete:
      operationId: GroupMembershipBulkDelete
      tags:
      - Group Memberships
      summary: Zendesk Delete Api V2 Group_memberships Destroy_many
      description: 'Immediately removes users from groups and schedules a job to unassign all working tickets that are assigned to the given user and group combinations.


        #### Allowed For


        * Admins

        * Agents assigned to a custom role with permissions to manage group memberships (Enterprise only)'
      parameters:
      - name: ids
        in: query
        description: Id of the group memberships to delete. Comma separated
        schema:
          type: string
        example: 1,2,3
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
              examples:
                default:
                  $ref: '#/components/examples/JobStatusBulkDeleteResponseExample'
  /api/v2/users/{user_id}/group_memberships/{group_membership_id}/make_default:
    parameters:
    - $ref: '#/components/parameters/UserId'
    - $ref: '#/components/parameters/GroupMembershipId'
    put:
      operationId: GroupMembershipSetDefault
      tags:
      - Group Memberships
      summary: Zendesk Put Api V2 Users User_id Group_memberships Group_membership_id…
      description: '#### Allowed For:


        * Agents'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMembershipsResponse'
              examples:
                default:
                  $ref: '#/components/examples/GroupMembershipsResponseExample'
components:
  schemas:
    GroupMembershipsResponse:
      type: object
      properties:
        group_memberships:
          type: array
          items:
            $ref: '#/components/schemas/GroupMembershipObject'
    JobStatusResponse:
      type: object
      properties:
        job_status:
          $ref: '#/components/schemas/JobStatusObject'
    GroupMembershipResponse:
      type: object
      properties:
        group_membership:
          $ref: '#/components/schemas/GroupMembershipObject'
x-refined-from:
- group-memberships-openapi-original.yml
- users-openapi-original.yml