---
title: "POST /v1/policies"
method: POST
path: "/v1/policies"
---

# POST /v1/policies

`POST /v1/policies`

## Request body

- object
  - `organization_id` string, required — The organization ID as the owner of the policy
  - `resource` string, required — The resource in which the policy will apply (e.g. wallet, user)
  - `operation` string, required — The operation where the resource participated in which the policy will apply
  - `name` string, required — The merchant defined name of the policy
  - `source` string, required — Base64 encoded string of the policy source code

## Response `201`

Created

- object
  - `data` object
    - `id` string — ID of the policy
    - `resource` string — The resource in which the policy will apply (e.g. wallet, user)
    - `operation` string — The operation where the resource participated in which the policy will apply
    - `name` string — The merchant defined name of the policy
    - `language` string — The programming language of which the policy is written
    - `source` string — Base64 encoded string of the policy source code
    - `status` string — Defines the status of the policy Possible values: `activated`: The policy is active and will be evaluated at runtime. `deactivated`: The policy is inactive and will not be evaluated at runtime. Usually used for drafting and will be the default value upon policy creation.
    - `created_at` string — The timestamp when the policy is created
    - `updated_at` string — The timestamp when the policy is last updated

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/paymongo/apis/paymongo-api.md) · [All operations](https://skmtc.net/paymongo/apis/paymongo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymongo/paymongo-api/versions/c18f9a027b2c/schema)