Simulations

Fund test customer

Add test funds to a connected customer's wallet

post/simulations/customers/{customerId}/transfers/deposit

Request

Base URL
https://api.sandbox.natural.com
URL
https://api.sandbox.natural.com/simulations/customers/{customerId}/transfers/deposit
Auth
HTTP bearer

customerIdstring required

Customer party ID (pty_*).

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Successful Response

Sep 30, 2026897916372a74 Revision changes
- info
  added the required property // to the response with the status
Sep 23, 2026bcf3b028c3e5 Revision changes
- info
  added the required property // to the response with the status