---
title: "Create an account program"
method: POST
path: "/v1/simulations/account_programs"
tags: ["Simulations"]
---

# Create an account program

`POST /v1/simulations/account_programs`

Creates a Mock-US USD account program owned by the caller merchant. This endpoint is unavailable in live production.

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateAccountProgramSimulationBodyDto
  - `label` string, required — Human-readable label for the account program.
  - `type` 'fbo-program' | 'fbo-sponsored', required — Account program type.

## Response `200`

The account program creation simulation acknowledgement

- AccountProgramSimulationResourceDto
  - `type` 'account_program_simulation', required — Resource type discriminator.
  - `success` boolean, required — Whether the simulation submission was successful.
  - `account_program_id` string, uuid, required — Account program whose lifecycle is being simulated.
  - `event` 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain', required — Account program lifecycle event submitted to the sandbox.
  - `payout_ids` string[], nullable, required — Payouts created by a drain event. Feed each id to `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.

## Changes

- **2026-08-27** `4549ed68144b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/augustus/apis/augustus-banking-api/changes/v1/simulations/account_programs/post.md)

---

[API](https://skmtc.dev/augustus/apis/augustus-banking-api.md) · [All operations](https://skmtc.dev/augustus/apis/augustus-banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/augustus-banking-api/revisions/e0010b51834a/schema)