---
title: "Create captcha policy"
method: POST
path: "/resources/configurations/v1/captcha-policy"
tags: ["Core settings"]
---

# Create captcha policy

`POST /resources/configurations/v1/captcha-policy`

## Request

- Base URL: `http://localhost:8181`
- URL: `http://localhost:8181/resources/configurations/v1/captcha-policy`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/docs/resources/configurations/v1/captcha-policy/post.ts> (a function with typed inputs; its response is checked against the schema)

This route creates a captcha policy for all tenants. To enable the Captcha Policy, make sure to set the enabled variable to true, the site key and secret key to the ones you got from reCaptcha and the minimum score to a number between 0 to 1.

## Request body

- CaptchaPolicyRequest
  - `enabled` boolean, required
  - `siteKey` string, required
  - `secretKey` string, required
  - `minScore` number, required
  - `ignoredEmails` string[]: Captcha validation will be skipped for those emails.

## Response `201`

- CaptchaPolicyResponse
  - `id` string, required
  - `siteKey` string, required
  - `secretKey` string, required
  - `enabled` boolean, required
  - `minScore` number, required
  - `ignoredEmails` string[], required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

---

[API](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp.md) - [All operations](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/llms.txt) - [OpenAPI document](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/revisions/c496ae9e1c3e?raw)