Invite User Accounts via Email

It's possible to invite new user accounts by email. In the Management UI, this is available from the Namespaces view's Actions → Invite new user accounts via email (which also lets you manage open invitations). Via the Management API, the endpoint for this is POST /api/rest/v1/invite/user — see your Trivore ID instance's /apidoc for the full reference.

Each email invite may be sent to multiple email addresses (invitees). Besides the email addresses, an invite has several optional attributes:

• email subject,
• email body text (may contain HTML, plain text, or both), and
• locale information (default is en for English).

Trivore ID specific details include (both optional again):

• the namespace code new accounts should be added to — if not given, accounts are added to the inviter's own namespace, and
• Group names the invitees should be added to as members once their account is created.

Each invite is sent as an individual email, to make tracking easier — so sending invites to a large number of people at once may take a while.

Besides sending invites, it's possible to query the current state of sent invites, resend one, or cancel a still-open one.

A namespace's User Interface settings control whether users may invite new accounts at all, and how many days an invite stays valid before it expires.

note

Verify unusual or bulk invites carefully before sending. It's easy to end up flagged as a spam sender, which can cause real deliverability problems — use user invites sparingly, mainly for known people such as company employees.