---
title: "Bulk request of Direct Debit mandates for the given account-id."
method: POST
path: "/mandates/bulk-create"
tags: ["Direct Debits"]
---

# Bulk request of Direct Debit mandates for the given account-id.

`POST /mandates/bulk-create`

## Request body

- DirectdebitBulkCreateMandateRequest — List of Details of the Direct Debit mandates.
  - `accountId` string, required — The unique identifier for the account for which the mandates are to be created.
  - `migrationType` 'SCHEDULE_AUDDIS_MIGRATION' | 'TRANSFER_OF_SUN' | 'OFFBOARDING', required — The type of migration process that is being initiated.
  - `auddisSubmissionDate` string, date — The scheduled date for the AUDDIS (Automated Direct Debit Instruction Service) submission. This is the date when the mandates will be submitted to the AUDDIS system for processing.
  - `createMandateRequests` DirectdebitCreateMandateRequest[], required — The number of mandate creation requests. Each item in the array represents a request to create an individual mandate with its own set of parameters.
    - `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

- DirectdebitBulkCreateResponse
  - `id` string, required — Unique id for this bulk request.
  - `accountId` string, required — Unique id for account for this bulk request.
  - `status` string, required — Status for this bulk request.
  - `migrationType` 'SCHEDULE_AUDDIS_MIGRATION' | 'TRANSFER_OF_SUN' | 'OFFBOARDING', required — Migration type for this bulk request.
  - `totalMandatesRequested` integer, required — Total mandates requested for this bulk request.
  - `auddisSubmissionDate` string, date, required — auddis submission date for this bulk request.

## 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/revisions/cbd52524c8ef/schema)