> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create intra-account transfer

> Use this endpoint to request an intra-account transfer.

POST/peertransfers

Use this endpoint to request an intra-account transfer. Add the source details to the body of the request in [JSON](http://www.json.org/) format.

When creating an intra-account transfer request, you must pass in both a token to identify the transfer sender (either `sender_user_token` or `sender_business_token`) and a token to identify the transfer recipient (either `recipient_user_token` or `recipient_business_token`). The sender and recipient objects must already exist.

> [!NOTE]
>
> **Note**\
> This feature is disabled by default and requires activation by Marqeta.
>
> This feature enables you to transfer or reallocate funds where the `sender` and the `recipient` belong to the same user within the card program. It does not allow you to transfer or reallocate funds between different users within the same card program, or between different card programs. Contact your Marqeta representative for more information.

## Request body

| Fields | Description |
| - | - |
| amount decimal  Required | Amount of the transfer. **Allowable Values:**  decimal **Format:** 0.00 |
| currency\_code string  Required | Three-digit ISO 4217 currency code. **Allowable Values:**  Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) |
| memo string  Optional | Additional descriptive text about the transfer. **Allowable Values:**  1–99 chars |
| recipient\_business\_token string  Optional | Specifies the business account holder that receives funds. Send a `GET` request to `/businesses` to retrieve business tokens. **Allowable Values:**  1–36 chars |
| recipient\_user\_token string  Optional | Specifies the user account holder that receives funds. Send a `GET` request to `/users` to retrieve user tokens. **Allowable Values:**  1–36 chars |
| sender\_business\_token string  Optional | Specifies the business account holder that sends funds. Send a `GET` request to `/businesses` to retrieve business tokens. **Allowable Values:**  1–36 chars |
| sender\_user\_token string  Optional | Specifies the user account holder that sends funds. Send a `GET` request to `/users` to retrieve user tokens. **Allowable Values:**  1–36 chars |
| tags string  Optional | Metadata about the intra-account transfer. **Allowable Values:**  1–255 chars |
| token string  Optional | Unique identifier of the intra-account transfer request. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. **Allowable Values:**  1–36 chars |

## Sample request body

```json JSON lines wrap theme={null}
{
  "token": "my_intra_account_transfer_01",
  "sender_user_token": "my_user_01",
  "recipient_user_token": "my_user_01_account_2",
  "currency_code": "USD",
  "amount": 50
}
```

## Response body

| Fields | Description |
| - | - |
| amount decimal  Returned | Amount of the transfer. **Allowable Values:**  decimal **Format:** 0.00 |
| currency\_code string  Returned | Three-digit ISO 4217 currency code. **Allowable Values:**  Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) |
| memo string  Conditionally returned | Additional descriptive text about the intra-account transfer. **Allowable Values:**  1–99 chars |
| recipient\_business\_token string  Conditionally returned | Specifies the business account holder that receives funds. **Allowable Values:**  1–36 chars |
| recipient\_user\_token string  Conditionally returned | Specifies the user account holder that receives funds. **Allowable Values:**  1–36 chars |
| sender\_business\_token string  Conditionally returned | Specifies the business account holder that sends funds. **Allowable Values:**  1–36 chars |
| sender\_user\_token string  Conditionally returned | Specifies the user account holder that sends funds. **Allowable Values:**  1–36 chars |
| tags string  Conditionally returned | Metadata about the intra-account transfer. **Allowable Values:**  1–255 chars |
| token string  Returned | Unique identifier of the intra-account transfer request. **Allowable Values:**  1–36 chars |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "my_intra_account_transfer_01",
  "amount": 50,
  "currency_code": "USD",
  "sender_user_token": "my_user_01",
  "recipient_user_token": "my_user_01_account_2",
  "created_time": "2023-03-11T19:15:01Z"
}
```


## Related topics

- [Intra-Account Transfers Overview](https://www.marqeta.com/docs/core-api/intra-account-transfers.md)
- [Retrieve intra-account transfer](https://www.marqeta.com/docs/core-api/intra-account-transfers/retrieve-intra-account.md)
- [Intra-Account Transfers Object](https://www.marqeta.com/docs/core-api/intra-account-transfers/intra-account-transfers-object.md)
- [List sent intra-account transfers](https://www.marqeta.com/docs/core-api/intra-account-transfers/list-sent-intra-account.md)
- [List received intra-account transfers](https://www.marqeta.com/docs/core-api/intra-account-transfers/list-received-intra-account.md)