---
title: Create a mandate
description: Create a new DebiPay mandate with the customer, payment method, and amount details required by the API.
openapi: /openapi/debi-pay-api.yaml POST /api/v1/mandates
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Use this endpoint to create a new mandate for a payer. The request payload includes the core mandate fields such as the mandate identifier, payer, contact number, amount, dates, and optional payment method information.

<Info>
The schema for this operation includes a rich mandate object, so review the generated request body in the right panel before sending your first request.
</Info>

## Fields to expect

Common fields in the request include:

- `id` for the mandate identifier
- `payer` and `contactNumber` as required values
- `amount`, `startDate`, and `actionDayId` for payment timing
- `bankAccount`, `bankCard`, or `paymentMethodId` for the chosen payment method
- Optional customer and merchant identifiers such as `customerId`, `merchantId`, and `reference`

## Typical use cases

- Set up a recurring debit mandate for a customer.
- Register a new mandate alongside a merchant account.
- Capture the signatory and contact details needed for mandate processing.

<Tip>
If you need to modify an existing mandate after creation, use the update endpoint rather than creating a duplicate mandate.
</Tip>

## Related pages

- [Get mandates](./mandates-get)
- [Get a mandate by id](./mandates-get-id)
- [Cancel a mandate](./mandate-cancel)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://mutex-core-apis.jamdesk.app/api-specs.zip