managing-users-and-accounts

Managing Users and Accounts

A general-purpose workflow for customer lookup and synthetic account setup. Use this broader skill when the task spans discovery, eligibility checks, and account creation. For narrow tasks, the more specific skills customer-overview and new-account-setup may be faster.

Guardrails

• Resolve people and accounts to UIDs before taking action.
• Confirm with the user before calling create-synthetic-account or delete-synthetic-accounts.
• Use sandbox credentials for testing.
• Treat KYC and locked status as blockers for funding and transfer workflows.

Step 1 — Find the Customer

If the user gives a UID directly:

get-customer  uid=<customer_uid>

Otherwise search first:

list-customers  (filter by first_name, last_name, email, external_uid, or pool_uid)

Record:

• uid
• external_uid
• customer_type
• status
• kyc_status and kyc_status_reasons
• locked / lock-related fields if present
• pool_uids
• total_balance

Step 2 — Check Whether the Customer Is Eligible for Account Activity

Before opening or using accounts, verify:

• customer status is active
• kyc_status is approved or otherwise acceptable for the requested workflow
• the customer is not locked

If these checks fail, stop and explain the blocker before attempting account creation or transfers.

Step 3 — Review Existing Synthetic Accounts

get-synthetic-accounts

Identify the customer's accounts by matching pool membership, naming, or known UIDs. If you already know an account UID, inspect it directly:

get-synthetic-account  uid=<synthetic_account_uid>

For each relevant account, note:

• uid, name, status
• synthetic_account_type_uid
• synthetic_account_category
• pool_uid
• net_usd_balance, net_usd_pending_balance, net_usd_available_balance
• routing_number, account_number_last_four
• payment rail blocks such as ach, wire, or instant_payment

Step 4 — Review Available Account Types