About the Account Invites API

The Wix Account Invites API enables you to invite individuals to join your Wix account as team members, so you can expand your team and delegate account responsibilities efficiently. With this API, you can send email invitations, granting new team members specific roles and access privileges within your account. Learn more about Roles & Permissions.

Use cases

Account invite lifecycle

The account invite lifecycle outlines the stages involved in sending, managing, and accepting invitations for individuals to become team members in a Wix account.

  1. Invite created: When Create Invite is called, an email invitation is created and sent to each invitee.
  2. Invitee receives email: The invitee receives the invite email.
  3. Invitee responds to invite: The invitee can take one of the following actions:
    • Accept the invite by following the link in the email, provided the invite is still valid (i.e., it is not expired or previously been used).
    • Ignore the invite until it expires.
  4. Role assigned: When an invitee accepts, they are assigned the role specified in the invite.

Terminology

  • Account: A collection of Wix assets, including sites, managed by one or more Wix users.
  • Asset: Everything within an account, including sites, domains, custom templates, and payment and billing info. Sometimes referred to as resource.
  • Assignment: The pairing of a Wix user's access to an asset and their assigned role. For example, Sally has access to the XYZ site owned by Jennifer with a website manager role, and Alice has access to Selena’s Wix account with a co-owner role.
  • 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.
  • Team member: A Wix user that has been added to an account, with access to one or more sites and other assets. One Wix user can be a team member of multiple accounts.
Did this help?

Sample Flows

This article shares some typical use cases you can support, as well as an example flow that supports each use case. You're certainly not limited to these use cases, but they can be a helpful jumping off point as you plan your implementation.

Invite company employees to join your company's Wix account

If your company has multiple employees, you can invite them to join your Wix account, whether or not they already have a Wix account.

Call Create Invite with the employees email addresses, the roles to assign (referred to here as policies), and any specific assets they should not have access to (referred to here as resources). If no assets are specified, the employee will be given access to all assets in the account.

When the employee accepts the invitation, their user ID is created (if relevant) and assigned as a team member of your account.

Did this help?

Account Invite Object


This service manages all invites related actions (site and account level)

Properties
idstringRead-onlyformat GUID

Invite ID.


accountIdstringRead-onlyformat GUID

Account ID.


emailstringformat EMAIL

Email address where the invite was sent.


rolestringdeprecated

Deprecated. Use policyIds.


inviterIdstringRead-onlydeprecated

Deprecated. Use inviterAccountId.


statusstring

Invite status.

Supported values:

  • Pending: The invite has been sent and is valid, waiting for the user's response.
  • Used: The invite has been accepted.
  • Deleted: The invite has been deleted or revoked.
  • Declined: The user has declined the invite.
  • Expired: The invite has expired without being accepted.

acceptLinkstring

Link to accept the invite.


inviterAccountIdstringRead-onlyformat GUID

Inviting account ID.


acceptedByAccountIdstringRead-onlyformat GUID

Account ID that accepted the invite. Populated only once the invite is accepted.


dateCreatedstringformat date-time

Date the invite was created.


policyIdsArray <string>

Role IDs included in the invite.


dateUpdatedstringformat date-time

Date the invite was last updated.


assignmentsArray <InviteResourceAssignment>

Assets the users are invited to join.


expirationDatestringformat date-time

Invite expiration date.

Did this help?

POST

Create Invite


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates and sends invite emails to a list of potential team members, inviting them to become team members of the requesting account. The invites may be limited to a specific resource (site or other asset). Maximum 50 invitees can be specified per call.

Important: This call requires an account level API key and cannot be authenticated with the standard authorization header. API keys are currently available to selected beta users only.

Endpoint
POST
https://www.wixapis.com/invites/account-invite/create

Body Params
subjectsAssignmentsArray <SubjectInviteAssignments>RequiredminItems 1maxItems 50

Array of potential team members' email addresses and their corresponding assignments (how they will be assigned when they accept the invite).


defaultEmailLanguagestring

Language of emails to send. Relevant only for recipients that don't currently have a Wix user ID. Default: Site owner's language.

Response Object
successfulInvitesArray <AccountInvite>

Invites that were sent successfully.


failedInvitesArray <InviteFailure>

Invites that failed.

Invite team member to account
Request
cURL
curl -X POST \ 'https://www.wixapis.com/invites/account-invite/create' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ -d '{ "subjectsAssignments": [ { "assignments": [ { "policyId": "6600344420111308827", "assignments": [] } ], "subjectEmail": "some@email.com" } ], }'
Response
JSON
{ "successfulInvites": [ { "id": "bfb00082-28bd-4da9-b234-9c60e6b821ed", "accountId": "<ACCOUNT-ID-FROM-AUTH-HEADER>", "email": "some@email.com", "inviterId": "fed9597b-0015-4cc2-b531-aff2ec248e7a", "acceptLink": "https://manage.wix.com/team/accept?....", "inviterAccountId": "fed9597b-0015-4de2-f530-aff2ec248e7a", "dateCreated": "2024-11-11T12:15:18Z", "dateUpdated": "2024-11-11T12:15:18Z", "assignments": [ { "policyId": "6600344420111308827" } ], "expirationDate": "2024-12-11T12:15:18Z" } ] }
Did this help?