Accept New User Invitation For External IdP User

post

https://{application_vanity_domain}/api/v1/new-user-invitation/external-idp/accept-invite

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Provisions the external IdP user. The user's email is marked as verified if it matches the invite email or if the IdP asserts that the email is verified

For profile attributes not configured to sync from the external IdP, you can manually provide values in the request body. If syncing is enabled for an attribute, its value from the external IdP will override any value you provide—unless the IdP value is null and the field is marked as required in the user schema. In that case, the request body value takes precedence.

Several responses can be returned from this API. Please refer to the result response field description to see the different types of responses that can be returned.

Required Permissions

Below is the list of required permissions needed to interact with this API. For each permission, the allowed permission boundaries are also specified.

Permission	Boundary	Description
new-user-invitation-workflow:execute	Application	The subject can perform this operation for requests associated with the application to which the subject belongs.

Body Params

External IdP Accept New User Invite Request JSON object

Request to accept an external IdP new user invitation.

externalIdpAuthCode

string

required

length ≥ 1

The external IdP auth code that will be used to authorize the request.

string

required

length between 1 and 200

Email used for authenticating a user. Must be unique per IdP and tenant.

fullName

string

length between 1 and 200

[Conditionally Required] The user's whole name, including their given name and surname, and sometimes any middle names, prefixes, or suffixes.

Required Conditions:

This value is required if the tenant's resolved user schema has full name set as required.

givenName

string

length between 1 and 200

[Conditionally Required] The given name, or first name in most Western languages.

Required Conditions:

This value is required if the tenant's resolved user schema has given name set as required.

familyName

string

length between 1 and 200

[Conditionally Required] The family name, or last name in most Western languages.

Required Conditions:

This value is required if the tenant's resolved user schema has family name set as required.

phoneNumber

string

length between 1 and 16

[Conditionally Required] The user's phone number in E.164 international format.

Required Conditions:

This value is required if the tenant's resolved user schema has phone number set as required.

birthdate

date

length between 1 and 10

[Conditionally Required] The user's birthdate.

Required Conditions:

This value is required if the tenant's resolved user schema has birthdate set as required.

Responses

Required Permissions

200OK

400Bad Request

401Unauthorized

403Forbidden

405Method Not Allowed

406Not Acceptable

409Conflict

415Unsupported Media Type

500Internal Server Error

503Service Unavailable