---
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

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)