Config Items

Upsert a config item

Creates or updates an organization-level config item by (organization_id, config_key). Intended for singleton-style keys such as expense_approvals_enabled.

put/v1/config_items

Request

  • Base URL
    https://api.paymongo.com
  • URL
    https://api.paymongo.com/v1/config_items
  • Auth
    HTTP basic

Request body

config_keystring required
labelstring
metadataobject
valuestring required

Example request

{
  "config_key": "expense_approvals_enabled",
  "label": "Approvals",
  "value": "true"
}

Response

Config item set

approved_countinteger
approved_total_amountinteger
has_moreboolean
pending_countinteger
rejected_countinteger
total_amountinteger

Example response

{
  "approved_count": 1,
  "approved_total_amount": 125000,
  "data": {
    "config_key": "budget_code",
    "created_at": "2026-07-15 01:30:00+00:00",
    "id": "oci_abc123",
    "label": "Marketing",
    "organization_id": "org_abc123",
    "type": "organization_config_item",
    "updated_at": "2026-07-15 01:35:00+00:00",
    "value": "MKT-001"
  },
  "has_more": true,
  "pending_count": 1,
  "total_amount": 250000
}

Changes

No recorded changes to this operation across all 1 revision of this API.