GET /api/v2/users/{user_id}/organizations

Returns a list of organizations associated with the specified user.

Pagination

See Pagination.

Returns a maximum of 100 records per page.

Allowed For

If the agent has a custom agent role that restricts their access to only users in their own organization, a 403 Forbidden error is returned. See Creating custom agent roles in Zendesk help.

Servers

Path parameters

Name Type Required Description
user_id Integer Yes

The id of the user

Query parameters

Name Type Required Description
page No

Pagination parameter. Supports both traditional offset and cursor-based pagination:

  • Traditional: ?page=2 (integer page number)
  • Cursor: ?page[size]=50&page[after]=cursor (deepObject with size, after, before)

These are mutually exclusive - use one format or the other, not both.

include_boundary_indicators Boolean No

When true, includes has_more indicator in the cursor pagination response meta.

Only valid with cursor pagination (page[size], page[after], page[before]).

per_page Integer No

Number of records to return per page.

Note: Default and maximum values vary by endpoint. Check endpoint-specific documentation for limits.

sort String No

Field to sort results by. Prefix with - for descending order.

When used with cursor pagination, this determines the cursor ordering.

Example: ?sort=name or ?sort=-created_at

include_item_cursors Boolean No

When true, includes cursor values for each item in the cursor pagination response.

Only valid with cursor pagination (page[size], page[after], page[before]).

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.