Skip to content

Re-send an invitation

POST
/api/public/v1/invitations/resend
curl --request POST \
--url https://example.com/api/public/v1/invitations/resend \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "Id": "example", "Email": "example" }'

Sends the invitation again, addressed by corporate email or by id. An employee who has already granted access, and an archived one, are rejected — there is nothing to send in either case.

Addresses one employee record by either handle. Give exactly one: the corporate email the record was created with, or the id a previous call returned.

object
Id
string
nullable
Email
string
nullable
Examplegenerated
{
"Id": "example",
"Email": "example"
}

OK

Media typeapplication/json

What happened to one invitation. A record that already exists is reported here rather than rejected — bool InvitationResultDto.Created is false and EmployeeStatus InvitationResultDto.Status is the existing record’s current state.

object
Id

The employee record’s id, whether it was created now or already existed.

string
Email
string
Created

True when this call created the record; false when it already existed.

boolean
Status
string
Allowed values: NotActivated Invited Activated Revoked
InvitationSent

Whether this call sent an invitation email. A record that already existed answers false — nothing was sent — and can be reached with resend.

boolean
PortalUrl

Where this person’s card lives in the Portal. Opening it needs a signed-in Portal session — the link is an address, not access.

string
nullable
Example
{
"Status": "NotActivated"
}

Bad Request

Media typeapplication/json

The Integration API’s error shape — RFC 7807 application/problem+json. The Portal API answers in its own { Error, Details } envelope because one client parses one shape; an external integrator expects the standard instead.

object
type
string
nullable
title
required
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Unauthorized

Media typeapplication/json

The Integration API’s error shape — RFC 7807 application/problem+json. The Portal API answers in its own { Error, Details } envelope because one client parses one shape; an external integrator expects the standard instead.

object
type
string
nullable
title
required
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Not Found

Media typeapplication/json

The Integration API’s error shape — RFC 7807 application/problem+json. The Portal API answers in its own { Error, Details } envelope because one client parses one shape; an external integrator expects the standard instead.

object
type
string
nullable
title
required
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}