---
title: "Create a configuration document"
method: POST
path: "/v1/merchant_configurations"
tags: ["merchant_configurations"]
---

# Create a configuration document

`POST /v1/merchant_configurations`

## Request

- Base URL: `https://ewallets-api.paymongo.com`
- URL: `https://ewallets-api.paymongo.com/v1/merchant_configurations`
- Auth: HTTP bearer

One document per organization, method and mode; a second answers 409. PayMongo-Actor names the writer and is recorded in the history. The organization must be the token's account.

## Headers

- `PayMongo-Actor` string, required
- `PayMongo-Livemode` 'true' | 'false', required

## Request body

- InternalMerchantconfigHandlerCreateMerchantConfigurationRequestDTO
  - `enabled` boolean
  - `features` object
  - `method` string, required
  - `organization_id` string, required
  - `provider` string
  - `providers` object
  - `reason` string
  - `settings` object

## Response `201`

Created

- object: Standard response containing data and its metadata if any
  - `data` InternalMerchantconfigHandlerMerchantConfigurationResponseDTO
    - `configured` boolean
    - `created_at` string
    - `enabled` boolean
    - `features` object
    - `id` string
    - `livemode` boolean
    - `method` string
    - `organization_id` string
    - `provider` string
    - `providers` object
    - `settings` object
    - `updated_at` string
    - `version` integer
  - `has_more` boolean

## Other responses

- `400`: Invalid body, missing actor, or a foreign organization_id
- `409`: resource_exists
- `422`: account_not_configured, feature_unsupported or schema_violation

---

[API](https://skmtc.dev/paymongo/apis/ewallets.md) - [All operations](https://skmtc.dev/paymongo/apis/ewallets/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/ewallets/revisions/a445ca65c132?raw)