---
title: "Create a Direct Debit mandate for the given account-id."
method: POST
path: "/accounts/{accountId}/mandates"
tags: ["Direct Debits"]
---

# Create a Direct Debit mandate for the given account-id.

`POST /accounts/{accountId}/mandates`

Setting up a Mandate is the first step in creating a Direct Debit. You can only set up scheduled payments ('collections') after there is a Mandate created with the details of the payee.

## Path parameters

- `accountId` string, required

## Request body

- DirectdebitCreateMandateRequest — Details of the Direct Debit mandate.
  - `name` string, required — Name for mandate
  - `reference` string, required — Mandate reference, should contain only letters, numbers, space, dot, ampersand, forward-slash , hyphen
  - `externalReference` string, required — External reference for mandate
  - `accountName` string, required — Payee's account name
  - `sortCode` string, required — Payee's sort code of account for which direct-debit-mandate has to be created.
  - `accountNumber` string, required — Payee's account number for which direct-debit-mandate has to be created.
  - `address` DirectdebitAddress, required
    - `addressLine1` string, required
    - `addressLine2` string
    - `postTown` string, required
    - `postCode` string, required
    - `country` string, required
  - `phone` string, required — Payee's phone number
  - `email` string — Payee's email address
  - `payeeAccountBid` string — Payee's accountBid

## Response `200`

OK

- DirectdebitMandate
  - `id` string, required — Unique id for direct-debit-mandate.
  - `accountId` string, required — Unique id for account for this mandate.
  - `reference` string, required — DDI reference that was used during creation.
  - `externalReference` string, required — External reference that was used during creation (appears on the bank statement).
  - `createdDate` string, date-time, required — Datetime when direct-debit-mandate was created.Format is 'yyyy-MM-dd'T'HH:mm:ssZ' where Z is UTC offset. e.g 2017-01-28T01:01:01+0000
  - `status` string, required — Status of the direct-debit-mandate. mandates must be 'ACTIVE' to make collections. Can be one of
  - `nextValidCollectionDate` string, required — The earliest date a collection can be created. Format is yyyy-MM-dd.
  - `Name given on Mandate` string
  - `Address given on Mandate` DirectdebitAddress
    - `addressLine1` string, required
    - `addressLine2` string
    - `postTown` string, required
    - `postCode` string, required
    - `country` string, required
  - `sortCode` string, required — Sort Code of the account for which direct-debit-mandate has been created.
  - `accountNumber` string, required — Account Number for which direct-debit-mandate has been created.
  - `payeeAccountBid` string — Unique id for individual recipient account used for internal transfers
  - `bulkCreateRequestId` string — Id associate to the bulk create request of this mandate.
  - `bulkCancelRequestId` string — Id associate to the bulk cancel request of this mandate.

## Other responses

- `400` — Validation errors
- `404` — Not Found

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)