Automations

Common Automation Flows

Fiat to Stablecoin (Onramp) - Automatically mints stablecoins when a fiat deposit is received.
Stablecoin to Fiat (Offramp) - Automatically converts stablecoins to fiat and withdraws to a bank account. (Coming Q3 2026)
Stablecoin to Stablecoin (Swap) - Automatically swaps one stablecoin for another. (Coming Q3 2026)

Automations can also be created in the Brale Dashboard on the Automations tab.

Automations on a transactional account (account_type: transactional) may only target external destinations. A Brale-custodied destination is rejected. See Account types and Individual accounts.

Onramp Automation with Virtual Accounts

Automations provide a unique account number and routing number for wire transfers and ACH deposits. When funds are received, stablecoins are automatically minted to a pre-defined wallet address. Businesses can use automations to direct unique pre-funding coordinates to their customers, which mint stablecoins in a customer’s wallet. Here’s what happens end-to-end when you use an onramp automation:

Create the automation
You define source.value_type as USD and set a destination wallet and stablecoin (e.g., SBC on solana) via the API or Dashboard.
Virtual account is provisioned
Brale provisions a virtual account and populates source.funding_instructions with bank details (routing number, account number, bank name, beneficiary).
Customer sends funds
You share those bank details with your customer. They send a wire or ACH to the virtual account - no additional API call is required.
Stablecoins are minted automatically
When funds arrive, Brale automatically creates a Transfer (USD → stablecoin), mints the stablecoin, and sends it to the destination.address_id configured on the automation.
Track activity via Transfers
You can reconcile and monitor all onramp activity by querying Transfers for the account:
GET /accounts/{account_id}/transfers.
Transfers created by automations include source.payment_details when Brale has underlying payment metadata to expose. Use this to identify the sender and reconcile inbound fiat payments. See Transfers — source.payment_details for details.

Creating an Automation

Create an automation to receive USD and automatically mint SBC to a Solana wallet. POST https://api.brale.xyz/accounts/{account_id}/automations

Request

{
  "name": "XYZ Onramp",
  "source": {
    "value_type": "USD"
  },
  "destination": {
    "address_id": "2MhCCIHulVdXrHiEuQDJvnKbSkl",
    "value_type": "SBC",
    "transfer_type": "Solana"
  }
}

Automations are opened in a pending state and automatically transition into processing. Once virtual accounts are created and the automation is ready to use, it will transition to a completed status.

Response

{
  "id": "35kVg1llbsOBYvx9XKr9eOtsD9z",
  "name": "Customer ABC Automation",
  "status": "pending",
  "source": {
    "transfer_type": null,
    "value_type": "USD"
  },
  "destination": {
    "transfer_type": "solana",
    "address_id": "35LWXNTO2jem13nXCLyciFdi162",
    "value_type": "ARB"
  },
  "updated_at": "2025-11-20T15:56:03.531196Z",
  "created_at": "2025-11-20T15:56:03.531196Z"
}

When an automation becomes active, the source.funding_instructions object is populated with the virtual account’s bank details (routing number, account number, beneficiary name, etc.). These are the coordinates you share with your customer to fund the automation.

Branded Automations

Branded Automations let you select the verified identity (business or individual) shown as the beneficiary on funding instructions for a virtual account. Add a brand object to the create request to control which account name appears on funding instructions:

Field	Where	Type	Description
`brand`	Body	object	`{ "account_id": "<ACCOUNT_ID>" }` — your own account or a managed account (business or individual) whose verified identity will appear as the beneficiary on wire and ACH funding instructions.

Behavior:

If brand is omitted, the beneficiary on funding instructions remains Brale.
If brand.account_id references a business account, beneficiary_name and beneficiary_address show the business name and address.
If brand.account_id references an individual account, beneficiary_name and beneficiary_address show the individual’s legal name and address.
The automation is still created under the account in the request path. brand.account_id selects the identity rendered on the funding instructions; it does not change which account owns the automation.

Request (business brand)

{
  "name": "XYZ Onramp",
  "source": { "value_type": "USD" },
  "destination": {
    "address_id": "2MhCCIHulVdXrHiEuQDJvnKbSkl",
    "value_type": "SBC",
    "transfer_type": "Solana"
  },
  "brand": { "account_id": "<BUSINESS_ACCOUNT_ID>" }
}

Request (individual brand)

{
  "name": "Jane Doe Onramp",
  "source": { "value_type": "USD" },
  "destination": {
    "address_id": "2MhCCIHulVdXrHiEuQDJvnKbSkl",
    "value_type": "SBC",
    "transfer_type": "Solana"
  },
  "brand": { "account_id": "<INDIVIDUAL_ACCOUNT_ID>" }
}

When the automation becomes active, beneficiary_name and beneficiary_address in source.funding_instructions reflect that account’s verified identity — the business name and address for a business account, or the individual’s legal name and address for an individual account. See Individual accounts for how to create an individual account whose identity can be used as a brand.

Testnet Behavior

Automations created on testnet deployments are fully functional for testing purposes, but no real banking account is provisioned. Instead of live banking coordinates, Brale returns placeholder account details in source.funding_instructions. Deposits sent to these coordinates will not be processed, and no actual funds movement occurs.

Listing Automations for a Customer

Retrieve all automations associated with a customer Account. GET https://api.brale.xyz/accounts/{account_id}/automations

Response

{
  "automations": [
    {
      "id": "35kVg1llbsOBYvx9XKr9eOtsD9z",
      "name": "Customer ABC Automation",
      "status": "active",
      "source": {
        "transfer_type": null,
        "value_type": "USD",
        "funding_instructions": {
          "bank_address": "123 Example St, Example City, NY 10001",
          "beneficiary_address": "456 Sandbox Ave, Suite 100, Example City, IA 50000",
          "beneficiary_name": "Example Payments Inc",
          "routing_number": "000111222",
          "account_number": "100123456789",
          "bank_name": "Example Bank",
          "memo": null
        }
      },
      "destination": {
        "transfer_type": "solana",
        "address_id": "35LWXNTO2jem13nXCLyciFdi162",
        "value_type": "ARB"
      },
      "updated_at": "2025-11-20T15:56:05.017508Z",
      "created_at": "2025-11-20T15:56:03.531196Z"
    },
    {
      "id": "35kVg1llbsOBYvx9XKr9eOtsD9z",
      "name": "Customer XYZ Automation",
      "status": "active",
      "source": {
        "transfer_type": null,
        "value_type": "USD",
        "funding_instructions": {
          "bank_address": "123 Example St, Example City, NY 10001",
          "beneficiary_address": "25 Main Ave, Suite 100, Example City, IA 50000",
          "beneficiary_name": "Company ABC",
          "routing_number": "000111222",
          "account_number": "000123456789",
          "bank_name": "Example Bank",
          "memo": null
        }
      },
      "destination": {
        "transfer_type": "solana",
        "address_id": "35LWXNTO2jem13nXCLyciFdi162",
        "value_type": "ARB"
      },
      "updated_at": "2025-11-20T15:56:05.017508Z",
      "created_at": "2025-11-20T15:56:03.531196Z"
    }
  ]
}

Retrieve an Automation

Retrieve a specific Automation. GET https://api.brale.xyz/accounts/{account_id}/automations/{automation_id}

Response

{
  "id": "35kVg1llbsOBYvx9XKr9eOtsD9z",
  "name": "Customer XYZ Automation",
  "status": "active",
  "source": {
    "transfer_type": null,
    "value_type": "USD",
    "funding_instructions": {
      "bank_address": "123 Example St, Example City, NY 10001",
      "beneficiary_address": "25 Main Ave, Suite 100, Example City, IA 50000",
      "beneficiary_name": "Company ABC",
      "routing_number": "000111222",
      "account_number": "000123456789",
      "bank_name": "Example Bank",
      "memo": null
    }
  },
  "destination": {
    "transfer_type": "solana",
    "address_id": "35LWXNTO2jem13nXCLyciFdi162",
    "value_type": "ARB"
  },
  "updated_at": "2025-11-20T15:56:05.017508Z",
  "created_at": "2025-11-20T15:56:03.531196Z"
}

Archive an Automation

Automations can be archived when they are no longer needed. Archiving permanently closes the automation’s virtual account — no further deposits will be processed — and removes the Stripe billing seat for the automation.

Archived is a terminal state. An archived automation cannot be re-enabled.

PATCH https://api.brale.xyz/accounts/{account_id}/automations/{automation_id}

Request

{
  "status": "archived"
}

Response

{
  "id": "3D8pEQwvYY7cJXmQkojpZZ9vdr3",
  "name": "ACE Corp 5",
  "status": "archived",
  "source": {
    "transfer_type": null,
    "value_type": "USD",
    "funding_instructions": {
      "account_number": "488255579773",
      "beneficiary_name": "Brand Account 2",
      "bank_address": "8700 Perry Highway Pittsburgh, PA 15237",
      "beneficiary_address": "7834 pipe drive San Diego, CA 92115",
      "routing_number": "043087080",
      "bank_name": "SSB Bank"
    }
  },
  "destination": {
    "address_id": "3D8odPs57kcf4kErbi8snLOQg0H",
    "transfer_type": "base",
    "value_type": "ACE"
  },
  "updated_at": "2026-06-04T21:13:53.122105Z",
  "created_at": "2026-05-01T22:10:38.297457Z",
  "brand": {
    "account_id": "3D8occi363tmBYDByo0Rr292kBO"
  }
}

Required scope: automations:write

Overview

Key concepts

Webhooks

Common Automation Flows

Onramp Automation with Virtual Accounts

Creating an Automation

Branded Automations

Testnet Behavior

Listing Automations for a Customer

Retrieve an Automation

Archive an Automation

​Common Automation Flows

​Onramp Automation with Virtual Accounts

​Creating an Automation

​Branded Automations

​Testnet Behavior

​Listing Automations for a Customer

​Retrieve an Automation

​Archive an Automation

Common Automation Flows

Onramp Automation with Virtual Accounts

Creating an Automation

Branded Automations

Testnet Behavior

Listing Automations for a Customer

Retrieve an Automation

Archive an Automation