Skip to main content
POST
Create User Invite
This page documents a frozen v1 API. It receives only critical correctness or security corrections. For new integrations, use the current API and follow the linked migration guide.
This endpoint will return a 400 Status Code in case the email address provided is already in use
The email field is validated for syntax. A malformed address is rejected with a 400 Status Code and the field-level error {"email": ["Invalid email address. Please provide a valid address."]}.Since September 02, 2026 this endpoint accepts a slightly wider range of valid addresses than before, for example addresses containing an apostrophe in the local part or a non-ASCII domain. Addresses that were accepted before are still accepted. Addresses longer than 128 characters are now rejected with the same error; previously they were accepted here and failed later when the invitation was stored.
This endpoint returns a 400 Status Code if the company has been offboarded (permanently closed) on paywise. Offboarded companies no longer accept new users or invitations, and no invite is created.

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

email
string
erforderlich

E-Mail of the user to invite

Minimum string length: 1
company
string<uuid>
erforderlich

UUID of the company that the user is going to be part of

success_url
string
erforderlich

Success URL - the user will be redirected here after successfully completing authentication flow

Minimum string length: 1
failure_url
string
erforderlich

Failure URL - the user will be redirected here if either the flow was cancelled or not completed for any other reason

Minimum string length: 1
id
string
Minimum string length: 1
first_name
string

First name of the user

Minimum string length: 1
last_name
string

Last name of the user

Minimum string length: 1

Antwort

email
string
erforderlich

E-Mail of the user to invite

company
string<uuid>
erforderlich

UUID of the company that the user is going to be part of

success_url
string
erforderlich

Success URL - the user will be redirected here after successfully completing authentication flow

failure_url
string
erforderlich

Failure URL - the user will be redirected here if either the flow was cancelled or not completed for any other reason

invite_url
string
erforderlich
read-only

Invite URL - Redirect your User to this URL for tem to complete the onboading process

expiry
string<date-time>
erforderlich
read-only

Expiry date/time of the request. After this timestamp is expired, users will have to be re-registered with a new invite

status
string
erforderlich
read-only

Current status of the User invite

id
string
first_name
string

First name of the user

last_name
string

Last name of the user