Create a new membership associating a user with either a company or an organisation node. Memberships define the relationship between users and the entities they can access within your organisation structure.

The membership must include a relationship to either a company or an organisation_node, but not both.

🔒 This endpoint requires an OAC (Organisation Access Credentials — ⚠️ Beta) access token with the memberships:write scope.

ℹ️ Each user can only have one membership per company or organisation node. Attempting to create a duplicate membership will result in an error. You can configure the user's role (admin, developer, viewer, etc.) and notification preferences when creating the membership.

⚠️ Upcoming feature: The meta.with_invitation option is not available yet. Support for sending invitation emails will be added soon.