Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getlemma.com/llms.txt

Use this file to discover all available pages before exploring further.

Saved recipients (also called external recipients) are external bank accounts that you save in Lemma for outbound transfers. They represent accounts outside of Lemma — such as a vendor, payroll provider, or another financial institution — that your organization sends money to. Saved recipients are the only way to transfer funds outside of Lemma. This is by design: requiring a pre-registered recipient prevents accidentally moving money to an account not associated with your provider’s funds. Every outbound transfer must target a saved recipient that belongs to your provider.

​
Creating recipients

Lemma users can create an external recipient through the Lemma dashboard. Platforms create external recipients via the Create external recipient endpoint. Every recipient requires a nickname — 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 recipients 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 recipients 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
Archived recipients are excluded from the list endpoint but can still be fetched directly with the get endpoint. They also remain visible in transaction history so you can always trace past payments.

​
Ownership and access control

Every external recipient belongs to a specific provider. Lemma enforces this at the transfer level. You cannot send money to an external recipient owned by a different provider. 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 the destination_account_id when calling Move money externally. Transfers to saved recipients are sent via ACH and typically settle within 1-2 business days.