---
title: "Create Mandate"
method: POST
path: "/v2/mandate-mgt/mandates/"
---

# Create Mandate

`POST /v2/mandate-mgt/mandates/`

This API lets you initiate a mandate on a customers bank account. Note: customer has to approve the mandate before it is in effect. The action the user would have to complete to approve the mandate, is contained within the response once the API call is made, in the `responseDescription` field

## Request body

- object
  - `amount` integer, required — This is the total amount to be debited during the course of the mandate
  - `description` string, required — A description of what the mandate is for
  - `startDate` string, date, required — When the mandate goes in effect
  - `endDate` string, date, required — The last day any debit would/can be initiated using the created mandate
  - `currency` string, required
  - `customer` object, required
    - `accountNumber` string, required — The customers account number to be debited
    - `accountName` string, required — The customers name as it appears on the bank account
    - `bankCode` string, required — The domiciliary bank code
    - `address` string, required — The customers address
    - `email` string, required — The customers email address
    - `phone` string, required — The customers phone number

## Response `200`

200

- object
  - `amount` integer
  - `description` string
  - `responseDescription` string
  - `startDate` string
  - `endDate` string
  - `status` string
  - `reference` string
  - `createdAt` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/fincra/apis/awesome-new-api.md) · [All operations](https://skmtc.net/fincra/apis/awesome-new-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fincra/awesome-new-api/revisions/c8215c27b460/schema)