About the Contributors API

The Contributors API allows account managers to retrieve a list of contributors for a given site and to change the contributors' roles for the site. This API enables you to manage contributor roles and permissions, so you can ensure that your customers have the appropriate access to their Wix sites.

Important:

This API is designed to manage customer access to a single site and is not intended for managing company employee access to sites.

For more information about site contributors, also referred to as site collaborators, including a list of available roles, see Roles & Permissions: Overview and Roles & Permissions: Information for Site Collaborators.

Before you begin

  • Wix recommends mapping your customers' identifiers (email, name, etc.) to their Wix user ID.
  • There is currently no way to retrieve a contributor's current roles via API.

Terminology

  • Account: A collection of Wix assets, including sites, managed by one or more Wix users. Every Wix user has an account that they own, and they can also be invited to join other user's accounts.
  • Assignment: The mapping of a Wix user's access to a site and their assigned role. For example, Sally has access to the XYZ site owned by Jennifer with a website manager role.
  • Collaborator: A Wix user with edit or manage access to a site owned by a separate Wix account, also referred to as a contributor. See Roles & Permissions: Overview and Roles & Permissions: Information for Site Collaborators.
  • Policy: See Role below.
  • Role: A defined type of access that an identity should have on a specific site or account. Wix provides several predefined roles, such as co-owner, website manager, and website designer. Account owners and co-owners can also define their own custom roles.
  • User: A logged in user on *.wix.com.
Did this help?