Zendesk Organization Memberships API

The Organization Memberships API from Zendesk — 7 operation(s) for organization memberships.

Business capability
Customer Data Management BC-420.10

Operations 9

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/organization_memberships List organization memberships · Zendesk Get Api V2 Organization_memberships #
Ask an LLM
“Which organizations does each user in my account belong to?”
“In what order are a user's organization memberships returned?”
Tell an agent
List the organization memberships in the account.
Show all user-to-organization memberships, default organization first.
POST /api/v2/organization_memberships Add a user to an organization · Zendesk Post Api V2 Organization_memberships #
Ask an LLM
“How do I assign a user to an organization?”
“What error comes back if the user is already in that organization?”
Tell an agent
Add this user to the given organization.
Create one organization membership for a customer.
GET /api/v2/organization_memberships/{organization_membership_id} Show an organization membership · Zendesk Get Api V2 Organization_memberships Organization_membership_id #
Ask an LLM
“Can I look up a single organization membership by its ID?”
“What does one membership record between a user and an organization contain?”
Tell an agent
Show the organization membership with that membership ID.
Fetch one user-organization membership record.
DELETE /api/v2/organization_memberships/{organization_membership_id} Remove an organization membership · Zendesk Delete Api V2 Organization_memberships Organization_membership_id #
Ask an LLM
“What happens to a user's working tickets when I remove their organization membership?”
“Can I delete a single membership by its membership ID?”
Tell an agent destructive · confirm first
Delete that organization membership by its membership ID.
Remove the membership and unassign the user's working tickets for that organization.
POST /api/v2/organization_memberships/create_many Bulk create organization memberships · Zendesk Post Api V2 Organization_memberships Create_many #
Ask an LLM
“Can I add up to 100 users to organizations in one job?”
“How do I track a bulk membership creation after it is queued?”
Tell an agent
Bulk create these organization memberships as a background job.
Assign many users to their organizations at once.
DELETE /api/v2/organization_memberships/destroy_many Bulk remove organization memberships · Zendesk Delete Api V2 Organization_memberships Destroy_many #
Ask an LLM
“Can I remove several organization memberships in one request?”
“Are working tickets unassigned when memberships are removed in bulk?”
Tell an agent destructive · confirm first
Delete the organization memberships {ids}.
Bulk remove memberships {ids} and unassign their working tickets.
PUT /api/v2/users/{user_id}/organization_memberships/{organization_membership_id}/make_default Make a membership the user's default · Zendesk Put Api V2 Users User_id Organization_memberships… #
Ask an LLM
“Can I choose which membership is a user's default using the membership ID?”
“Are agents allowed to set the default membership for an end user?”
Tell an agent
Make that organization membership the user's default, by membership ID.
Set a user's default membership using the membership record.
DELETE /api/v2/users/{user_id}/organizations/{organization_id} Remove a user from an organization · Zendesk Delete Api V2 Users User_id Organizations Organization_id #
Ask an LLM
“Can I take a user out of a specific organization using the user and organization IDs?”
“Does unassigning a user from an organization affect their open tickets?”
Tell an agent destructive · confirm first
Unassign the user from that organization by user ID and organization ID.
Take this customer out of the organization they belong to.
PUT /api/v2/users/{user_id}/organizations/{organization_id}/make_default Make an organization the user's default · Zendesk Put Api V2 Users User_id Organizations Organization_id Make_default #
Ask an LLM
“Can I set a user's default organization by pointing at the organization ID?”
“Which call makes a given organization primary for a user?”
Tell an agent
Switch the customer's default to the organization with that organization ID.
Set the customer's primary organization.

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

Schemas & Data

Other Resources

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-organization-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.

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

OpenAPI Specification

zendesk-organization-memberships-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Zendesk Organization Memberships API
  version: '1.0'
  description: 'Operations tagged Organization Memberships across 3 of this provider''s published API definitions: organization-memberships-openapi-original.yml, organizations-openapi-original.yml, users-openapi-original.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: Organization Memberships
paths:
  /api/v2/organization_memberships:
    get:
      operationId: ListOrganizationMemberships
      tags:
      - Organization Memberships
      summary: Zendesk Get Api V2 Organization_memberships
      description: 'Returns a list of organization memberships for the account, user or organization in question.


        **Note**: When returning organization memberships for a user, organization memberships are sorted with the default organization first, and then by organization name.


        #### Pagination


        * Cursor pagination (recommended)

        * Offset pagination


        See Pagination.


        Returns a maximum of 100 records per page.


        #### Allowed For


        - Agents

        - End users'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembershipsResponse'
              examples:
                default:
                  $ref: '#/components/examples/OrganizationMembershipsResponseExample'
    post:
      operationId: CreateOrganizationMembership
      tags:
      - Organization Memberships
      summary: Zendesk Post Api V2 Organization_memberships
      description: 'Assigns a user to a given organization. Returns an error with status 422 if the user is already assigned to the organization.


        #### Allowed For


        * Admins

        * Agents when creating a new organization membership for an end user'
      responses:
        '201':
          description: Created response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembershipResponse'
              examples:
                default:
                  $ref: '#/components/examples/OrganizationMembershipCreateResponseExample'
  /api/v2/organization_memberships/{organization_membership_id}:
    parameters:
    - $ref: '#/components/parameters/OrganizationMembershipId'
    get:
      operationId: ShowOrganizationMembershipById
      tags:
      - Organization Memberships
      summary: Zendesk Get Api V2 Organization_memberships Organization_membership_id
      description: '#### Allowed for


        * Agents'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembershipResponse'
              examples:
                default:
                  $ref: '#/components/examples/OrganizationMembershipResponseExample'
    delete:
      operationId: DeleteOrganizationMembership
      tags:
      - Organization Memberships
      summary: Zendesk Delete Api V2 Organization_memberships Organization_membership_id
      description: 'Immediately removes a user from an organization and schedules a job to unassign all working tickets currently assigned to the user and organization combination. The `organization_id` of the unassigned tickets is set to null.


        #### Allowed for


        * Admins

        * Agents when deleting an organization membership for an end user'
      responses:
        '204':
          description: No Content response
  /api/v2/organization_memberships/create_many:
    post:
      operationId: CreateManyOrganizationMemberships
      tags:
      - Organization Memberships
      summary: Zendesk Post Api V2 Organization_memberships Create_many
      description: 'Accepts an array of up to 100 organization membership objects.


        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. Only a certain number of jobs can be queued or running at the same time. See Job limit for more information.


        #### Allowed For

        * Admins

        * Agents'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
              examples:
                default:
                  $ref: '#/components/examples/OrganizationMembershipCreateManyResponseExample'
  /api/v2/organization_memberships/destroy_many:
    delete:
      operationId: DeleteManyOrganizationMemberships
      tags:
      - Organization Memberships
      summary: Zendesk Delete Api V2 Organization_memberships Destroy_many
      description: 'Immediately removes a user from an organization and schedules a job to unassign all working tickets currently assigned to the user and organization combination. The `organization_id` of the unassigned tickets is set to null.


        #### 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. Only a certain number of jobs can be queued or running at the same time. See Job limit for more information.


        #### Allowed For


        * Agents'
      parameters:
      - name: ids
        in: query
        description: The IDs of the organization memberships to delete
        schema:
          type: array
          items:
            type: integer
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
              examples:
                default:
                  $ref: '#/components/examples/JobStatusBulkDeleteResponseExample'
  /api/v2/users/{user_id}/organization_memberships/{organization_membership_id}/make_default:
    parameters:
    - $ref: '#/components/parameters/UserId'
    - $ref: '#/components/parameters/OrganizationMembershipId'
    put:
      operationId: SetOrganizationMembershipAsDefault
      tags:
      - Organization Memberships
      summary: Zendesk Put Api V2 Users User_id Organization_memberships…
      description: 'Sets the default organization membership of a given user.


        #### Allowed for


        * Admins

        * Agents when setting the default organization membership for an end user'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembershipsResponse'
              examples:
                default:
                  $ref: '#/components/examples/OrganizationMembershipsResponseExample'
  /api/v2/users/{user_id}/organizations/{organization_id}:
    parameters:
    - $ref: '#/components/parameters/OrganizationId'
    - $ref: '#/components/parameters/UserId'
    delete:
      operationId: UnassignOrganization
      tags:
      - Organization Memberships
      summary: Zendesk Delete Api V2 Users User_id Organizations Organization_id
      description: 'Immediately removes a user from an organization and schedules a job to unassign all working tickets currently assigned to the user and organization combination. The `organization_id` of the unassigned tickets is set to null.


        #### Allowed For


        * Agents'
      responses:
        '204':
          description: No Content response
  /api/v2/users/{user_id}/organizations/{organization_id}/make_default:
    parameters:
    - $ref: '#/components/parameters/UserId'
    - $ref: '#/components/parameters/OrganizationId'
    put:
      operationId: SetOrganizationAsDefault
      tags:
      - Organization Memberships
      summary: Zendesk Put Api V2 Users User_id Organizations Organization_id Make_default
      description: 'Sets the default organization membership of a given user.


        #### Allowed For


        * Agents'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembershipResponse'
              examples:
                default:
                  $ref: '#/components/examples/OrganizationMembershipResponseExample'
components:
  schemas:
    JobStatusResponse:
      type: object
      properties:
        job_status:
          $ref: '#/components/schemas/JobStatusObject'
    OrganizationMembershipResponse:
      type: object
      properties:
        organization_membership:
          $ref: '#/components/schemas/OrganizationMembershipObject'
    OrganizationMembershipsResponse:
      type: object
      properties:
        organization_memberships:
          type: array
          items:
            $ref: '#/components/schemas/OrganizationMembershipObject'
x-refined-from:
- organization-memberships-openapi-original.yml
- organizations-openapi-original.yml
- users-openapi-original.yml