Organisations API reference

Reference map for Organisations API operations.

Updated
Apr 26, 2026

Organisations

Use this reference map to choose the operation group before opening an endpoint page for exact request and response details.

Use Organisations when the job is customer/account-context organisation work through the Auth API.

Auth API organisation operations own current-user organisation listing, registration, reads, patching, deletion, organisation trees, organisation-user membership, and organisation attribute relationships.

Use Organizations when the job is trusted Management API administration of organization records, tags, addresses, restrictions, and merchant-user access. The spelling difference reflects the historical APIs; choose by API and caller context.

For workflow guidance across Management Organizations, Auth Organisations, Merchant Users, Users, attributes, customer groups, and events, see Organizations and account access.

Read and inspect

Create or attach

OperationAPI
Add user to organisationAuth API

Update or repair

OperationAPI
Patch organisationAuth API

Remove or deactivate

Other operations

OperationAPI
Register new organisationAuth API

Organisations API reference

# Organisations Use this reference map to choose the operation group before opening an endpoint page for exact request and response details. Use Organisations when the job is customer/account-context organisation work through the Auth API. Auth API organisation operations own current-user organisation listing, registration, reads, patching, deletion, organisation trees, organisation-user membership, and organisation attribute relationships. Use Organizations when the job is trusted Management API administration of organization records, tags, addresses, restrictions, and merchant-user access. The spelling difference reflects the historical APIs; choose by API and caller context. For workflow guidance across Management Organizations, Auth Organisations, Merchant Users, Users, attributes, customer groups, and events, see [Organizations and account access](/start/concepts/organizations-and-account-access).

10 operations grouped by the job they support.

## Read and inspect | Operation | API | | --- | --- | | [Get organisation](/reference/organisations/get-organisation) | Auth API | | [Get organisation by organisation number](/reference/organisations/get-organisation-by-organisation-number) | Auth API | | [Get organisation tree](/reference/organisations/get-organisation-tree) | Auth API | | [List organisations](/reference/organisations/list-organisations) | Auth API | | [List users for an organisation](/reference/organisations/list-users-for-an-organisation) | Auth API | ## Create or attach | Operation | API | | --- | --- | | [Add user to organisation](/reference/organisations/add-user-to-organisation) | Auth API | ## Update or repair | Operation | API | | --- | --- | | [Patch organisation](/reference/organisations/patch-organisation) | Auth API | ## Remove or deactivate | Operation | API | | --- | --- | | [Delete organisation](/reference/organisations/delete-organisation) | Auth API | | [Remove user from organisation](/reference/organisations/remove-user-from-organisation) | Auth API | ## Other operations | Operation | API | | --- | --- | | [Register new organisation](/reference/organisations/register-new-organisation) | Auth API |