Creating recipients
Lemma users can create an external account through the Lemma dashboard. Platforms create external accounts via the Create external account endpoint. Every recipient requires anickname — a non-nullable text field that serves as a human-readable label in the dashboard. Choose something your team will recognize at a glance (e.g., “Owner’s personal account” rather than “Acct 4821”).
Immutability
External accounts cannot be edited after creation. This is necessary for reconciliation and audit purposes. If account details could change, it would be impossible to reliably trace which bank account a historical transfer was sent to. If you need to correct a mistake, archive the existing recipient and create a new one.Archiving vs. deleting
External accounts are never deleted, only archived. When you archive a recipient, Lemma:- Sets the recipient’s status to
archived - Rejects any new transfers targeting that recipient
- Keeps the record in the database for reconciliation and audit trail
Ownership and access control
Every external account belongs to a specific entity. Lemma enforces this at the transfer level. You cannot send money to an external account owned by a different entity. This ensures each practice’s funds can only be sent to accounts they have explicitly registered.Using recipients in transfers
Pass a recipient ID as thedestination_account_id when calling Move money externally. Transfers to saved recipients are sent via ACH and typically settle within 1-2 business days.
Related endpoints
- Create external account — save a new external bank account
- Get external account — retrieve a single external account by ID
- List external accounts — retrieve active external accounts for an entity