---
title: "Investment plan creation (USER_DATA)"
method: POST
path: "/sapi/v1/lending/auto-invest/plan/add"
tags: ["Auto-Invest"]
---

# Investment plan creation (USER_DATA)

`POST /sapi/v1/lending/auto-invest/plan/add`

## Request

- Base URL: `https://api.binance.com`
- URL: `https://api.binance.com/sapi/v1/lending/auto-invest/plan/add`
- Auth: API key in header `X-MBX-APIKEY`

Post an investment plan creation

Weight(IP): 1

## Query parameters

- `sourceType` 'MAIN_SITE' | 'TR', required
- `requestId` string
- `planType` 'SINGLE' | 'PORTFOLIO' | 'INDEX', required
- `IndexId` integer
- `subscriptionAmount` number, float, required
- `subscriptionCycle` 'H1' | 'H4' | 'H8' | 'H12' | 'WEEKLY' | 'DAILY' | 'MONTHLY' | 'BI_WEEKLY', required
- `subscriptionStartDay` integer
- `subscriptionStartWeekday` 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | 'SUN'
- `subscriptionStartTime` integer, required
- `sourceAsset` string, required
- `flexibleAllowedToUse` boolean
- `details` object[], required
  - `targetAsset` string
  - `percentage` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

Plan result

- object
  - `planId` integer, required
  - `nextExecutionDateTime` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized Request

## Changes

- **2023-12-07** `2db60fa8dfed`: 1 breaking
  - the `query` request parameter `details` became required
- **2023-09-28** `1c55b3bb10d7`: 2 breaking
  - for the `query` request parameter `details`, the type of property `items/percentage` was specialized from `number` to `integer`
  - for the `query` request parameter `IndexId`, the type changed from `number` to `integer`
- **2023-09-19** `558ab69ec555`: 1 warning
  - deleted the `query` request parameter `UID`
- **2023-09-02** `6622e0c15100`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/lending/auto-invest/plan/add/post.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) - [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/binance/apis/binance-public-spot-api/revisions/0dd2f133e12d?raw)