admin

list

Filter results by organization identifier.

organizationId

userId

Filter the results by the specified flow type.

type

Whether to filter out flows not in the `START_PENDING` or `STARTED`
state.

active

The identifier of the user that created the flow.

When this is specified only the flows created by the user are
returned.

creatorUserId

The maximum number of flows to return. The API may return fewer than
this value.

If unspecified, at most 20 flows will be returned.
The maximum value is 100; values above 100 will be coerced to 100.

pageSize

A page token, received from a previous list flows call.
Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to list flows must match
the call that provided the page token.

pageToken

A comma-separated list of fields to order by.

Supports:
- `createTime desc`

orderBy

The Flow view to return in the results.

This defaults to the `BASIC` view.

view

Create a join organization flow.

This invites a person to join an organization.

create-join-organization

The identifier of the user.

This is required if email is not specified.

The email address of the person to invite.

This is required if user is not specified or the user
does not have an email address.

email

The display name of the person to invite.

displayName

The identifier of the user sending the invite.

The time the flow will expire.

This field is not allowed if `ttl` is specified.

expireTime

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.

Create a signup flow.

This invites a person to join the app.

create-signup

The email address of the person to invite.

Whether to create an organization as part of the signup flow.

createOrganization

flowId

cancel

flows

Filter results by organization identifier.

This is required if user identifier is not specified.

Filter results by user identifier.

This is required if organization identifier is not specified.

The maximum number of invoices to return. The API may return fewer than
this value.

If unspecified, at most 20 invoices will be returned.
The maximum value is 100; values above 100 will be coerced to 100.

A page token, received from a previous list invoices call.
Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to list invoices must match
the call that provided the page token.

A comma-separated list of fields to order by.

Supports:
- `createTime asc`
- `createTime desc`

invoiceId

invoices

Filter the results by display name.

To enable prefix filtering append `*` to the end of the value
and ensure you provide at least 3 characters excluding the
wildcard.

This filter is case-insensitivity.

Filter the results by email address.

To enable prefix filtering append `*` to the end of the value
and ensure you provide at least 3 characters excluding the
wildcard.

This filter is case-insensitivity.

The maximum number of organizations to return. The API may return fewer than
this value.

If unspecified, at most 20 organizations will be returned.
The maximum value is 100; values above 100 will be coerced to 100.

A page token, received from a previous list organizations call.
Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to list organizations must match
the call that provided the page token.

A comma-separated list of fields to order by.

Supports:
- `displayName asc`
- `email asc`
- `signupTime desc`
- `createTime desc`
- `deleteTime desc`

showDeleted

The organization view to return in the results.

This defaults to the `BASIC` view.

create

The client defined unique identifier of the organization account.

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 `org_` are reserved.

uniqueId

The human-readable display name of the organization.

The maximum length is 200 characters.

The email address of the organization.

The maximum length is 320 characters.

Whether the organization's email address has been verified.

emailVerified

The E164 phone number for the organization (e.g. `+12125550123`).

phoneNumber

Whether the organization's phone number has been verified.

phoneNumberVerified

The photo/avatar URL of the organization.

The maximum length is 2000 characters.

imageUrl

The default ISO-4217 currency code for the organization (e.g. `USD`).

currencyCode

The IETF BCP-47 language code for the organization (e.g. `en`).

languageCode

The country/region code for the organization (e.g. `US`).

regionCode

The IANA time zone for the organization (e.g. `America/New_York`).

timeZone

The billing address for the organization.

address

signupTime

disabled

update

If set to true, and the organization is not found, a new organization will be created.

You must use the unique identifier for the identifier when this is true.

allowMissing

Marks specified organization for deletion.

delete

Un-marks specified organization for deletion.

undelete

Connect specified organization to external account.

connect

connectionId

The external identifier of the organization to connect.

On create if this is empty a new external organization will
be created if the connection supports it.

externalId

Disconnect specified organization from external account.

This will delete all the data associated with the connected account, including
payment methods, invoices, and subscriptions.

If the delete external account option is enabled it will also attempt to delete
the external account (e.g. Stripe Customer object).

WARNING: This can irreversibly destroy data and should be
used with extreme caution.

disconnect

Whether to attempt to delete the external account and all
it's associated data (e.g. Stripe Customer object).

deleteExternalAccount

list-members

roleId

The maximum number of members to return. The API may return fewer than
this value.

If unspecified, at most 20 members will be returned.
The maximum value is 100; values above 100 will be coerced to 100.

A page token, received from a previous list members call.
Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to list members must match
the call that provided the page token.

A comma-separated list of fields to order by.

Supports:
- `displayName asc`
- `email asc`
- `createTime desc`

add-member

get-member

update-member

If set to true, and the member is not found, a new member will be created.

remove-member

organizations

state

Filter results by plan group identifier.

You can specify `unmanaged` to see all subscriptions without a plan.

planGroupId

The maximum number of subscriptions to return. The API may return fewer than
this value.

If unspecified, at most 20 subscriptions will be returned.
The maximum value is 100; values above 100 will be coerced to 100.

A page token, received from a previous list subscriptions call.
Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to list subscriptions must match
the call that provided the page token.

A comma-separated list of fields to order by.

This is only supported when either `organizationId` or `userId` is specified.

Supports:
- `active desc`
- `createTime desc`
- `startTime desc`

The Subscription view to return in the results.

This defaults to the `BASIC` view.

subscriptionId

subscriptions

The maximum number of users to return. The API may return fewer than
this value.

If unspecified, at most 20 users will be returned.
The maximum value is 100; values above 100 will be coerced to 100.

A page token, received from a previous list users call.
Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to list users must match
the call that provided the page token.

The User view to return in the results.

This defaults to the `BASIC` view.

The client defined unique identifier of the user account.

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 `usr_` are reserved.

The human-readable display name of the user.

The maximum length is 200 characters.

The email address of the user.

The maximum length is 320 characters.

Whether the user's email address has been verified.

The E164 phone number for the user (e.g. `+12125550123`).

Whether the user's phone number has been verified.

The photo/avatar URL of the user.

The maximum length is 2000 characters.

The default ISO-4217 currency code for the user (e.g. `USD`).

The IETF BCP-47 language code for the user (e.g. `en`).

The country/region code for the user (e.g. `US`).

The IANA time zone for the user (e.g. `America/New_York`).

If set to true, and the user is not found, a new user will be created.

You must use the unique identifier for the identifier when this is true.

Connect specified user to external account.

The external identifier of the user to connect.

On create if this is empty a new external user will
be created if the connection supports it.

Disconnect specified user from external account.

This will delete all the data associated with the connected account, including
payment methods, invoices, and subscriptions.

If the delete external account option is enabled it will also attempt to delete
the external account (e.g. Stripe Customer object).

WARNING: This can irreversibly destroy data and should be
used with extreme caution.

Import user from external identity provider if they don't already
exist.

If the user already exists in UserHub, this is a no-op.

import-account

The identifier of the user.

This must be in the format `<externalId>@<connectionId>` where
`externalId` is the identity provider user identifier and
and `connectionId` is the User Provider connection identifier.

create-api-session

create-portal-session

The user ID.

In addition to supporting the UserHub user ID,
you can also pass in the User Provider external identifier in the
format `<externalId>@<connectionId>` and if the user doesn't
exist in UserHub they will automatically be imported.

The portal URL, this is the target URL on the portal site.

If not defined the root URL for the portal will be used.

This does not need to be the full URL, you have the option
of passing in a path instead (e.g. `/`).

You also have the option of including the `{accountId}`
string in the path/URL which will be replaced with either the
UserHub user ID (if `organizationId` is not specified)
or the UserHub organization ID (if specified).

Examples:
* `/{accountId}` - the billing dashboard
* `/{accountId}/plans` - select a plan to checkout
* `/{accountId}/checkout/<some-plan-id>` - checkout specified plan
* `/{accountId}/cancel` - cancel current plan
* `/{accountId}/members` - manage organization members
* `/{accountId}/invite` - invite a user to an organization

portalUrl

The URL the user should be sent to when they want to return to
the app (e.g. cancel checkout).

If not defined the app URL will be used.

returnUrl

The URL the user should be sent after they successfully complete
an action (e.g. checkout).

If not defined the return URL will be used.

successUrl

The organization ID.

When specified the `{accountId}` in the `portalUrl` will be
replaced with the organization ID, otherwise the user ID
will be used.

Create API session

path parameters

Returns

Create API session

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

Returns

path parameters