Use API_ProvisionUser to add a user who is not yet registered with Quick Base to your application. You invoke an application-level dbid for a user that is not yet registered with Quick Base, but whose email is known to you. This call:
starts a new user registration in Quick Base using the supplied email, fname (first name), and lname (last name).
gives application access to the user by adding the user to the specified role.
Note that, to assign roles to users, you must have either of these permissions on the application:
Basic Access with Sharing -- If you have Basic Access with Sharing permissions, you can assign roles with all permissions except Full Administration.
Full Administration -- If you have Full Administration permissions, you can assign roles with all permissions.
After you invoke this call, you’ll need to invoke API_SendInvitation to invite the new user via email. When the user clicks on the email invitation, the user is prompted to complete the brief registration. (At this time, the user can change the first and last name you assigned.)
If a user already is registered with Quick Base, the API will return an error. With registered users, you should use API_GetUserInfo, API_AddUserToRole, and API_SendInvitation.
The email address of the person to whom you are granting access.
The role ID of the role you want to assign this user to. You can find this information by invoking API_GetRoleInfo.
If you don’t supply a roleid, the role will be set to none.
The first name of the new Quick Base user.
The last name of the new Quick Base user.
A valid authentication ticket.
The authentication ticket is returned via the API_Authenticate call.
yes, one of:
The user token is an alternative means of authentication, used for API access. User tokens cannot be used to access the Quick Base UI.
yes, one of:
A valid application token.
yes, if the application requires application tokens
A string value that you want returned. It will not be handled by Quick Base but it will be returned in the response.
The originating request, for example, API_ProvisionUser.
Identifies the error code, if any. (See the Error Codes appendix for a list of possible error codes.)
0 indicates that no error was encountered.
Text that explains the error code.
"No error" indicates that no error was encountered.
The userid for the new user returned by Quick Base.
Optional. Contains any udata value supplied in the request.
where target_domain is the domain against which you are invoking this call, for example, quickbase.com. Read about this notation.
<?xml version="1.0" ?>
Did this help you? Give us a rating:
© 1999-2020 QuickBase, Inc. All rights reserved. Legal Notices.