{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/products/payments-direct-2/user-interface/guides/add-a-user","default":true,"active":true,"folderId":"eb16255d"},{"version":"v2026.03","label":"v2026.03","link":"/products/payments-direct-2/v2026.03/user-interface/guides/add-a-user","default":false,"active":false,"folderId":"eb16255d"},{"version":"v2025.11","label":"v2025.11","link":"/products/payments-direct-2/v2025.11/user-interface/guides/add-a-user","default":false,"active":false,"folderId":"eb16255d"}],"sharedDataIds":{"sidebar":"sidebar-products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Add a user","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"add-a-user","__idx":0},"children":["Add a user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this guide to add a new user to your organization in the ","Payments Direct"," interface and assign the appropriate role and permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must be signed in as an Organization Administrator or User Administrator."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your organization cannot already have 5 Organization Administrators if you intend to assign that role to the new user."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-open-the-users-page","__idx":2},"children":["Step 1: Open the Users page"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the left navigation, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Users page lists all current users in your organization."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-open-the-new-user-form","__idx":3},"children":["Step 2: Open the New User form"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New User"]}," in the upper right corner of the page."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-enter-user-information","__idx":4},"children":["Step 3: Enter user information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Information"]},", complete the following fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["First Name"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Maximum 50 characters"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Last Name"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Maximum 50 characters"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Email"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The user's login email address. Maximum 100 characters. Cannot be changed after the user is created."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-select-a-role","__idx":5},"children":["Step 4: Select a role"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Role"]},", select one of the following:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Role"},"children":["Role"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization Administrator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Full access to all features, including assigning permissions to other users. Limited to 5 per organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Administrator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Manages the company profile and assigns permissions to other users. Excluded from payment activity."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Assigned specific permissions for payment operations."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your organization already has 5 Organization Administrators, that option is disabled."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-assign-permissions-operator-role-only","__idx":6},"children":["Step 5: Assign permissions (Operator role only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you selected ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operator"]},", a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions"]}," section appears. Select the specific permissions to grant the user:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Can Read"},"children":["Can Read"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Can Edit"},"children":["Can Edit"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payments"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["API credentials"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Identities"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Payment creation in production"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Granting ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payments: Can Edit"]}," allows the user to create payments in the production environment. Assign this permission only to users who need to initiate payments for your customers."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-6-set-environment-access-operator-role-only","__idx":7},"children":["Step 6: Set environment access (Operator role only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your organization has multiple environments configured, an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment"]}," section appears. Select the environments the new user should be able to access. At least one environment must be selected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payments Direct"," users can be granted access to Production and UAT environments."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-7-save-the-user","__idx":8},"children":["Step 7: Save the user"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save User"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A confirmation message appears when the account is created successfully. The new user receives an invitation to set up their login."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-to-do-next","__idx":9},"children":["What to do next"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To update a user's role or permissions, select the user's name from the Users list to open the Edit User form."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To remove a user from your organization, select the action menu on the user's row in the Users table and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete User"]},"."]}]}]},"headings":[{"value":"Add a user","id":"add-a-user","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Open the Users page","id":"step-1-open-the-users-page","depth":2},{"value":"Step 2: Open the New User form","id":"step-2-open-the-new-user-form","depth":2},{"value":"Step 3: Enter user information","id":"step-3-enter-user-information","depth":2},{"value":"Step 4: Select a role","id":"step-4-select-a-role","depth":2},{"value":"Step 5: Assign permissions (Operator role only)","id":"step-5-assign-permissions-operator-role-only","depth":2},{"value":"Step 6: Set environment access (Operator role only)","id":"step-6-set-environment-access-operator-role-only","depth":2},{"value":"Step 7: Save the user","id":"step-7-save-the-user","depth":2},{"value":"What to do next","id":"what-to-do-next","depth":2}],"frontmatter":{"title":"Add a user","seo":{"title":"Add a user"}},"lastModified":"2026-05-27T18:08:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-direct-2/user-interface/guides/add-a-user","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}