---
title: "Manage Beneficiaries v2"
method: POST
path: "/v2/banking/beneficiary"
---

# Manage Beneficiaries v2

`POST /v2/banking/beneficiary`

## Headers

- `client_id` string, required
- `client_secret` string, required
- `module_secret` string, required
- `provider_secret` string, required

## Request body

- object
  - `action` string, required
  - `ifsc` string
  - `sender_account_number` string, required
  - `account_number` string
  - `beneficiary_code` string
  - `transfer_type` string
  - `email` string
  - `sender_mobile` string
  - `upi_handle` string
  - `mobile` string
  - `name` string

## Response `200`

200

- union
  - object
    - `decentroTxnId` string
    - `status` string
    - `responseCode` string
    - `message` string
    - `data` object
      - `ifsc` string
      - `accountNumber` string
      - `beneficiaryCode` string
      - `beneficiaryName` string
  - object
    - `decentroTxnId` string
    - `status` string
    - `responseCode` string
    - `message` string
    - `data` object
      - `ifsc` string
      - `accountNumber` string
      - `beneficiaryCode` string
      - `beneficiaryName` string
  - object
    - `decentroTxnId` string
    - `status` string
    - `responseCode` string
    - `message` string
    - `data` object
      - `ifsc` string
      - `accountNumber` string
      - `beneficiaryCode` string
  - object
    - `decentroTxnId` string
    - `status` string
    - `responseCode` string
    - `message` string
    - `data` object
      - `ifsc` string
      - `accountNumber` string
      - `beneficiaryCode` string

## Other responses

- `400` — 400
- `401` — 401

---

[API](https://skmtc.dev/decentro/apis/decentro-staging.md) · [All operations](https://skmtc.dev/decentro/apis/decentro-staging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decentro/decentro-staging/revisions/f1a86ce4638c/schema)