---
title: "Create the collection schedule for the given mandate-id."
method: POST
path: "/mandates/{mandateId}/collectionschedules"
tags: ["Direct Debits"]
---

# Create the collection schedule for the given mandate-id.

`POST /mandates/{mandateId}/collectionschedules`

Creates a Direct Debit collection schedule; the agreed to framework for the collections for the given mandate-id. This could be a single collection or multiple and includes the frequency and amounts of the planned payments.

## Path parameters

- `mandateId` string, required

## Request body

- DirectdebitCreateCollectionScheduleRequest — Details of collection to create.
  - `frequency` 'ONCE' | 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUALLY' | 'ANNUALLY' | 'WEEKLY' | 'EVERY_TWO_WEEKS' | 'EVERY_FOUR_WEEKS', required — Frequency for direct-debit collection. Can be one of: ONCE, WEEKLY, EVERY_TWO_WEEKS, EVERY_FOUR_WEEKS, MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUALLY.
  - `numberOfPayments` integer, required — Number of payments for direct-debit collection, must be '1' where frequency is 'ONCE'.
  - `firstPaymentAmount` number — Amount of the first collection payment.<br> Note: your item limit is set during onboarding will be lower than field maximum and Bacs scheme item limit of £20m.
  - `firstPaymentDate` string — Date of the first collection payment, format must be: yyyy-MM-dd
  - `regularPaymentAmount` number — Amount of the regular collection payments following first collection amount. Does not apply where the frequency is 'ONCE'.<br> Note: your item limit is set during onboarding will be lower than field maximum and Bacs scheme item limit of £20m
  - `regularPaymentStartDate` string — Start date of the regular collection payment, format: yyyy-MM-dd<br> Note: Does not apply where the frequency is 'ONCE'.
  - `currency` string, required — Currency in which payment should be made. Must be 'GBP' currently.
  - `externalReference` string — External Reference for collection schedule, should contain only alphanumeric characters, underscore, hyphen and space.<br> For your internal reconciliation only, not sent to Bacs scheme.
  - `collectionReference` string — An optional additional collection specific reference to be appended to the reference of the mandate.<br> This is concatenated after the core reference of the mandate, and will be truncated if combined reference is >18 characters.<br> Should only contain alphanumeric characters, dot, ampersand, forward-slash and hyphen only.
  - `collectionCorrelationName` string — (If enabled by Modulr) an optional collection specific reference appended to abbreviated SU name for the given collection schedule. If feature not enabled, any parameter supplied will be ignored.<br> When is enabled, this value is concatenated to a Service User Name abbreviation (set by Modulr) to form a Service User name containing extra information that can be used by payer to correlate (identify) transaction easily.<br> Characters restricted to: alphanumeric characters, numbers, space, dot, ampersand, forward-slash and hyphen only.

## Response `200`

OK

- DirectdebitCollectionScheduleResponse
  - `id` string, required — Unique id for direct-debit collection.
  - `frequency` string, required — Frequency for direct-debit collection
  - `numberOfPayments` integer, required — Number of payments for direct-debit collection
  - `firstPaymentAmount` number — Amount of the first collection payment
  - `firstPaymentDate` string — Date of the first collection payment. Format is yyyy-MM-dd.
  - `regularPaymentAmount` number — Amount of the regular collection payments
  - `regularPaymentStartDate` string — Start date of the regular collection payment. Format is yyyy-MM-dd.
  - `createdDate` string, date-time, required — Datetime when direct-debit collection 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 collection. Can be one of
  - `externalReference` string
  - `collectionReference` string

## 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)