Docs/Admin API/Flows/Create signup

Send a signup invitation

POST/admin/v1/flows:createSignup

Create a signup flow.

This invites a person to join the app.

body parameters

email
string
Required
The email address of the person to invite.
displayName
string
The display name of the person to invite.
createOrganization
boolean
Whether to create an organization as part of the signup flow.
creatorUserId
string
The identifier of the user sending the invite.
expireTime
date-time
The time the flow will expire.
This field is not allowed if ttl is specified.
ttl
string
The amount of time a flow will be available (e.g. 86400s).
This must be a string with the number of seconds followed by a trailing s.
This field is not allowed if expireTime is specified.

Returns

id
string
The system-assigned identifier of the flow.
state
enum
The current state of the flow.
Possible values:
START_PENDINGSTARTEDCOMPLETEDCANCELEDEXPIRED
stateReason
string
The code that best describes the reason for the state.
type
enum
The flow type.
Possible values:
JOIN_ORGANIZATIONSIGNUP
organization
Organization
BASIC
The target organization for the flow.
id
string
The system-assigned identifier of the organization.
state
enum
The current state of the organization.
Possible values:
ACTIVEDISABLEDARCHIVEDPENDING_DELETION
stateReason
string
The code that best describes the reason for the state.
uniqueId
string
The client defined unique identifier of the organization account.
displayName
string
The human-readable display name of the organization.
email
string
The email address of the organization.
emailVerified
boolean
Whether the organization's email address has been verified.
phoneNumber
string
The E164 phone number for the organization (e.g. +12125550123).
phoneNumberVerified
boolean
Whether the organization's phone number has been verified.
imageUrl
string
The photo/avatar URL of the organization.
currencyCode
string
The default ISO-4217 currency code for the organization (e.g. USD).
languageCode
string
The IETF BCP-47 language code for the organization (e.g. en).
regionCode
string
The country/region code for the organization (e.g. US).
timeZone
string
The IANA time zone for the organization (e.g. America/New_York).
address
Address
The default address for the organization.
lines
string[]
The address lines.
city
string
The city, district, suburb, town, or village.
state
string
The state, country, province, or region.
postalCode
string
The ZIP or postal code.
country
string
The 2-letter country code.
signupTime
date-time
The sign-up time for the organization.
memberCount
int32
The number of members in the organization.
This includes disabled users, but does not include user's marked for deletion.
disabled
boolean
Whether the organization is disabled.
view
enum
The organization view.
Possible values:
BASICFULL
createTime
date-time
The creation time of the organization.
updateTime
date-time
The last update time of the organization.
user
User
BASIC
The target user for the flow.
id
string
The system-assigned identifier of the user.
state
enum
The current state of the user.
Possible values:
ACTIVEDISABLEDARCHIVEDPENDING_DELETION
stateReason
string
The code that best describes the reason for the state.
uniqueId
string
The client defined unique identifier of the user account.
displayName
string
The human-readable display name of the user.
email
string
The email address of the user.
emailVerified
boolean
Whether the user's email address has been verified.
phoneNumber
string
The E164 phone number for the user (e.g. +12125550123).
phoneNumberVerified
boolean
Whether the user's phone number has been verified.
imageUrl
string
The photo/avatar URL of the user.
currencyCode
string
The default ISO-4217 currency code for the user (e.g. USD).
languageCode
string
The IETF BCP-47 language code for the user (e.g. en).
regionCode
string
The country/region code for the user (e.g. US).
timeZone
string
The IANA time zone for the user (e.g. America/New_York).
address
Address
The default address for the user.
lines
string[]
The address lines.
city
string
The city, district, suburb, town, or village.
state
string
The state, country, province, or region.
postalCode
string
The ZIP or postal code.
country
string
The 2-letter country code.
signupTime
date-time
The sign-up time for the user.
disabled
boolean
Whether the user is disabled.
view
enum
The user view.
Possible values:
BASICFULL
createTime
date-time
The creation time of the user.
updateTime
date-time
The last update time of the user.
creator
User
BASIC
The user who created the flow.
This will not be set if the invitation was created by an admin.
id
string
The system-assigned identifier of the user.
state
enum
The current state of the user.
Possible values:
ACTIVEDISABLEDARCHIVEDPENDING_DELETION
stateReason
string
The code that best describes the reason for the state.
uniqueId
string
The client defined unique identifier of the user account.
displayName
string
The human-readable display name of the user.
email
string
The email address of the user.
emailVerified
boolean
Whether the user's email address has been verified.
phoneNumber
string
The E164 phone number for the user (e.g. +12125550123).
phoneNumberVerified
boolean
Whether the user's phone number has been verified.
imageUrl
string
The photo/avatar URL of the user.
currencyCode
string
The default ISO-4217 currency code for the user (e.g. USD).
languageCode
string
The IETF BCP-47 language code for the user (e.g. en).
regionCode
string
The country/region code for the user (e.g. US).
timeZone
string
The IANA time zone for the user (e.g. America/New_York).
address
Address
The default address for the user.
lines
string[]
The address lines.
city
string
The city, district, suburb, town, or village.
state
string
The state, country, province, or region.
postalCode
string
The ZIP or postal code.
country
string
The 2-letter country code.
signupTime
date-time
The sign-up time for the user.
disabled
boolean
Whether the user is disabled.
view
enum
The user view.
Possible values:
BASICFULL
createTime
date-time
The creation time of the user.
updateTime
date-time
The last update time of the user.
startTime
date-time
The start time of the flow.
expireTime
date-time
The time the flow will expire.
ttl
string
The expire duration of the flow.
secret
string
The flow secret.
This is only populated on create.
joinOrganization
JoinOrganizationFlow
The join organization flow type specific data.
displayName
string
The display name of the invitee.
email
string
The email address of the invitee.
role
Role
The role to be assigned to the invitee.
id
string
The system-assigned identifier of the role.
uniqueId
string
The client defined unique identifier of the role.
It is restricted to letters, numbers, underscores, and hyphens, with the first character a letter or a number, and a 255 character maximum.
ID's starting with role_ are reserved.
displayName
string
The human-readable display name of the role.
type
enum
The role type.
Possible values:
OWNERMEMBERGUEST
description
string
The description of the role.
The maximum length is 1000 characters.
seatPolicy
enum
The policy that defines how a member is assigned a seat.
Possible values:
DEFAULTMANUAL
permissionSets
string[]
The additional permissions allowed by the role.
default
boolean
Whether the role is the default for the tenant.
archived
boolean
The archived status of the role.
view
enum
The role view.
Possible values:
BASICFULL
createTime
date-time
The creation time of the role.
updateTime
date-time
The last update time of the role.
signup
SignupFlow
The signup flow type specific data
email
string
The email address of the invitee.
displayName
string
The display name of the invitee.
createOrganization
boolean
Whether to create an organization as part of the signup flow.
view
enum
The flow view.
Possible values:
BASICFULL
createTime
date-time
The creation time of the flow.
updateTime
date-time
The last update time of the flow.

code
enum
The general error code (e.g. INVALID_ARGUMENT).
Possible values:
OKCANCELLEDUNKNOWNINVALID_ARGUMENTDEADLINE_EXCEEDEDNOT_FOUNDALREADY_EXISTSPERMISSION_DENIEDUNAUTHENTICATEDRESOURCE_EXHAUSTEDFAILED_PRECONDITIONABORTEDOUT_OF_RANGEUNIMPLEMENTEDINTERNALUNAVAILABLEDATA_LOSS
message
string
A developer-facing error message.
reason
string
A reason code for the error (e.g. USER_PENDING_DELETION).
param
string
The parameter path related to the error (e.g. member.userId).
metadata
string
Additional metadata related to the error.
localeMessage
string
A user-facing error message.

curl https://api.userhub.com/admin/v1/flows:createSignup \
  -H "Authorization: Bearer $USERHUB_ADMIN_KEY" \
  --json '{
    "email": "[email protected]"
  }'

const res = await adminApi.flows.createSignup({
  email: "[email protected]",
});

res, err := adminApi.Flows().CreateSignup(
    context.Background(),
    &adminapi.FlowCreateSignupInput{
        Email: "[email protected]",
    },
)

$res = $adminApi->flows->createSignup(
    email: '[email protected]',
);

res = admin_api.flows.create_signup(
    email="[email protected]",
)

Response bodyJSON

{
  "id": "flow_2VSCZXUfZVeRY3",
  "state": "START_PENDING",
  "type": "SIGNUP",
  "expireTime": "2025-06-15T13:00:00Z",
  "secret": "3fnpb3kr3q4ymtmD5Hnmh19GuD1uDzXdZeRZ3R",
  "signup": {
    "email": "[email protected]"
  },
  "view": "FULL",
  "createTime": "2025-05-15T13:00:00Z",
  "updateTime": "2025-05-15T13:00:00Z"
}

PreviousUpdate a join organization invitation

NextGet a flow

Send a signup invitation

.css-10iahqc{text-transform:capitalize;}body parameters

Returns

body parameters