Invite someone to join an organization.

Emails an invitation to join the team organization with the given role. The invitation is valid for 14 days; the invitee accepts it with POST /invitations/{invitationId}/accept. Requires the invitations.create permission, which the admin and owner roles hold.

The owner role cannot be granted by invitation. Inviting anyone needs the organization's plan to include collaboration, and roles other than developer must be offered by that plan. When the organization restricts members to allowed email domains, the email must be in one of them. An organization holds at most 50 pending invitations.

When the organization belongs to an enterprise and the email is an account already in that enterprise's directory, no invitation is sent: the account is added as a member at the role at once, and the response's type is member rather than invitation.