---
title: Upload mandates
description: Upload a file of mandate records for bulk creation or import through the DebiPay mandates API.
openapi: /openapi/debi-pay-api.yaml POST /api/v1/mandates/upload
---

> **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 upload a file containing mandate data for bulk processing. It is helpful when you need to import a large number of mandates from a file rather than submitting them one-by-one through the create endpoint.

<Info>
This operation is designed for batch import scenarios and includes the merchant identifier and idempotency key as request parameters.
</Info>

## Typical use cases

- Bulk import mandates from an external system.
- Upload a backlog of mandate records for a merchant.
- Process large-scale onboarding activities without individual API calls.

## Request details

The request uses a multipart form upload with a file field named `File`. The API also accepts `MerchantId` and `IdempotencyKey` as query parameters to help you manage large imports safely.

## Response handling

The API returns a confirmation that the upload was accepted and the import process was initiated. You can review the resulting mandate records using the mandate collection and detail endpoints.

<Tip>
Use the `IdempotencyKey` when you want to retry the same upload without accidentally creating duplicate mandate records.
</Tip>

## Related pages

- [Create a mandate](./mandates-create)
- [Get mandates](./mandates-get)
- [Upload mandate cancellations](./mandates-upload-cancellations)


---

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