---
title: "Create sandbox transactions"
method: POST
path: "/sandbox/transactions/create"
tags: ["plaid"]
---

# Create sandbox transactions

`POST /sandbox/transactions/create`

Use the `/sandbox/transactions/create` endpoint to create new transactions for an existing Item. This endpoint can be used to add up to 10 transactions to any Item at a time.

This endpoint can only be used with Items that were created in the Sandbox environment using the `user_transactions_dynamic` test user. You can use this to add transactions to test the `/transactions/get` and `/transactions/sync` endpoints.

Custom transactions are only applied to the depository account. Support for per-account targeting may be added in the future.

## Request body

- SandboxTransactionsCreateRequest — SandboxTransactionsCreateRequest defines the request schema for `/sandbox/transactions/create`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `access_token` string, required — The access token associated with the Item for which data is being requested.
  - `transactions` CustomSandboxTransaction[], required — List of transactions to be added
    - `date_transacted` string, date, required — The date of the transaction, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format. Transaction date must be the present date or a date up to 14 days in the past. Future dates are not allowed.
    - `date_posted` string, date, required — The date the transaction posted, in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format. Posted date must be the present date or a date up to 14 days in the past. Future dates are not allowed.
    - `amount` number, double, required — The transaction amount. Can be negative.
    - `description` string, required — The transaction description.
    - `iso_currency_code` string — The ISO-4217 format currency code for the transaction. Defaults to USD.

## Response `200`

OK

- SandboxTransactionsCreateResponse — SandboxTransactionsCreateResponse defines the response schema for `/sandbox/transactions/create`
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Other responses

- `400` — Invalid request
- `default` — Error response

## Changes

> 52 revisions in range; 1 could not be searched.

- **2026-07-22** `a1bbca018160` — 26 warning
  - added the new `ASSETS_ERROR` enum value to the `error_type` response property for the response status `400`
  - added the new `ASSETS_ERROR` enum value to the `error_type` response property for the response status `default`
  - added the new `CRA_MONITORING_ERROR` enum value to the `error_type` response property for the response status `400`
  - added the new `CRA_MONITORING_ERROR` enum value to the `error_type` response property for the response status `default`
  - …22 more
- **2026-06-25** `80d23bfdc2e5` — 2 warning
  - added the new `IDEMPOTENCY_ERROR` enum value to the `error_type` response property for the response status `400`
  - added the new `IDEMPOTENCY_ERROR` enum value to the `error_type` response property for the response status `default`
- **2026-06-10** `fb8c3f188d8b` — 2 warning
  - added the new `BASE_REPORT_ERROR` enum value to the `error_type` response property for the response status `400`
  - added the new `BASE_REPORT_ERROR` enum value to the `error_type` response property for the response status `default`
- …earlier changes not shown

[Full history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/sandbox/transactions/create/post.md)

---

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