Manually Create a Custom Signup Workflow

Instead of using the Custom Registration default or custom pages, you can (if desired) create a custom registration flow via the Action Framework. You do this using the Registration API.

Why would you want to do this? Rather than using the standard registration flow, you might want to embed signup ability into a button within the header of an existing page that is accessible to unauthenticated guest users. This allows these “visiting” users to sign up for their own account at their leisure.

Enable user registration

  1. Navigate to Settings > Site permission sets.
  2. Click Configure in the More menu next to the site permission set where you want to enable a custom signup experience.
  3. In the User Signup tab, check Enable User Registration for this site permission set.

Create the custom signup action

In the Skuid page where you want to add the signup ability, drag and drop a Button Set and add a button labeled Signup.

  1. In the button’s Actions tab, click fa-plus-circle Add Action and configure the action:

    • Action Type: Run Platform Action

    • Platform Action: Register New User

    • Site Permission Set Name: Select a site permission set that has Enable User Registration for this site permission set selected. Depending upon the site permission set, Skuid will present a variety of property options. The following values are required for all site permission set:

      • First Name

      • Last Name

      • Email Address

      • User Name


        Password is also required if the site permission set does not have Require email verification on signup checked.

    • Other possible values:

      • Federation Id: A field in the Salesforce interface that allows admins to pick whatever username or username format they want to pass to Salesforce from their user directory for single sign-on.
      • Locale: A valid locale code consisting of language and regional location, such as en-US, es-ES.
      • Time Zone: a valid tz database time zone code (for example, America/Los_Angeles, or Europe/London)

Create a User Signup Flow with the User Signup REST API


  • The Registration API is subject to various time-based rate limits. If you make too many requests per interval, subsequent requests are rejected with a 429 Rate Limit Exceeded error. (The number of allowed and used requests per time interval are returned in a response header.)

  • You can only create new end users as long as your site’s subscription limits have not been exceeded. Once limits are exceeded, new user creation will throw an error.

  • All users created using the Registration API are active by default.

  • All users created using the Registration API are created with the Portal subscription type by default. Usage for this type of end user is billed per login.

    Admins can elevate a Portal user to a Full subscription (for which usage is billed per user / per month) by editing the user’s type in their record on the Configure > Users tab.

For any site permission set with the Registration API is enabled, you can create new users by making a POST request to the site permission set’s corresponding REST API URL. All required parameters must be provided as key-value pairs in a JSON request body.

Example request:


Content-Type: application/json

  "firstName": "Myasia",
  "lastName": "Harvey",
  "email": "[email protected]",
  "username": "myasia",
  "federationId": "Myasia.Harvey",
  "password": "this is a terrible password"