---
title: "Create Deposit"
method: POST
path: "/bamboo/webhook"
tags: ["Deposits"]
---

# Create Deposit

`POST /bamboo/webhook`

## Request

- Base URL: `https://powered-by-bamboo-sandbox.investbamboo.com`
- URL: `https://powered-by-bamboo-sandbox.investbamboo.com/bamboo/webhook`
- Auth: none declared. Required headers: `content-type`, `accept-language`, `x-user-id`, `x-subject-type`, `x-client-token`, `x-request-source`

To make a deposit, you send a notification request with the necessary details to credit the user's brokerage account. Upon receiving the request, a record is created in our system and verification checks are performed to confirm the deposit source.

Verification is carried out using an endpoint you provide to our integration team during account setup. Once the deposit is verified, the specified amount is credited to the user's brokerage account, and deposit status events are sent via Google Pub/Sub. (see details under [events section](#section/Deposit-Event))

### Verification Endpoint Requirements:
- **Request Type:** GET
- **URL Pattern:** THE_URL/deposit/status/YOUR_UNIQUE_REFERENCE
- **Authentication:** Static hash in headers (share this hash with Bamboo along with your verification URL)

#### Example JSON Webhook Response:
    {
      "data": {
        "status": "settled", // or "failed"
        "currency": "NGN",
        "amount": 30000.00
      },
      "status": "settled" // or "failed"  
    }
**NB:** You can also  monitor all deposit activity through the <a href="http://pbb.investbamboo.com/"> PBB Dashboard</a>.

## Headers

- `content-type` string, required
- `accept-language` string, required
- `x-user-id` string, required
- `x-subject-type` string, required
- `x-client-token` string, required
- `x-request-source` string, required

## Request body

- Bamboowebhook
  - `amount_paid` number, required: Amount to be deposited
  - `currency` string, required: Currency
  - `provider` string, required: API Consumer Name
  - `reference` string, required: Deposit reference
  - `phone_number` string, required: User phone number
  - `transaction_date` string, required: Date of creating the transaction
  - `market` string: Either "US" or "NGX". It's used to specify desired stock market. If no market is specified, it defaults to US.

## Response `200`

200 OK

- string: No response body for this endpoint

## Other responses

- `400`: Bad request
- `422`: Incomplete Parameters

---

[API](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api.md) - [All operations](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/revisions/063521e8d924?raw)