Skip to content

SendInviteResponse

The invite just created, and whether its e-mail went out. A failed send doesn’t undo the invite: it can still be re-sent and accepted, so the request succeeds and emailSent is false.

Kind: an object, used in responses.

Every field is present in a response; empty ones are null.

FieldTypeDescription
emailSentbooleanFalse when the invite was stored but its e-mail could not be sent.
inviteUrlstring | nullThe link that accepts the invite, so you can pass it on another way. Set only when the e-mail of an invite into the tenant could not be sent; null otherwise.
invitationCodeIduuidThe id of the invitation code the invite was sent with.
emailAddressstringThe e-mail address the invite was sent to. Only that address can accept it.
inviteToTenantbooleanWhether the invite joins the inviter’s tenant (true) or registers a new tenant (false).
statusInviteStatusWhether the invite is still open, was cancelled or has been accepted.
grantsAdminboolean | nullTrue when the person who accepts the invite (POST /users/register) joins as a tenant admin (Tenant.Admin) rather than an ordinary member. Null or false: an ordinary member.
userCreatedByIduuidThe id of the user who created it. A call made with an API key is recorded as the key’s user.
tenantIduuidThe id of the tenant it belongs to.
iduuidThe unique id. Use it in by-id routes and wherever another object refers to this one.
dateCreateddatetimeWhen it was created, in UTC.
dateUpdateddatetimeWhen it was last changed, in UTC.
{
"emailSent": false,
"inviteUrl": "...",
"invitationCodeId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"emailAddress": "...",
"inviteToTenant": false,
"status": "Unused",
"grantsAdmin": false,
"userCreatedById": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
"dateCreated": "2026-10-26T12:00:00.0000000Z",
"dateUpdated": "2026-10-26T12:00:00.0000000Z"
}