---
title: "Create Proxy Profile"
method: POST
path: "/v1/organizations/{organizationId}/proxy-profiles"
tags: ["Proxy Profiles"]
---

# Create Proxy Profile

`POST /v1/organizations/{organizationId}/proxy-profiles`

## Request

- Base URL: `https://api.configcat.com`
- URL: `https://api.configcat.com/v1/organizations/{organizationId}/proxy-profiles`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/configcat/apis/configcat-public-management-api/docs/v1/organizations/:organizationId/proxy-profiles/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint creates a new Proxy Profile in the given Organization
identified by the `organizationId` parameter, which can be obtained from the [List Organizations](#operation/get-organizations) endpoint.

## Path parameters

- `organizationId` string, uuid, required

## Request body

- CreateOrUpdateProxyProfileRequest
  - `name` string, required: The name of the proxy profile.
  - `description` string, nullable: The description of the proxy profile.
  - `connectionPreferences` CreateOrUpdateConnectionPreferences: The preferences related to a connection, including polling intervals and webhook proxy configurations.
    - `sdkPollInterval` integer, nullable: The SDK poll interval in seconds. If not specified, a default value (60) will be used.
    - `webhookNotification` CreateOrUpdateWebhookNotification: The preferences related to a connection, including polling intervals and webhook proxy configurations.
      - `webhookProxyUrl` string, required: The webhook proxy URL for receiving config JSON change notifications.
  - `sdkKeySelectionRules` UpdateProxyProfileSelectionRule[], nullable: A collection of selection rules that determine the SDK keys applicable for a proxy profile.
    - `kind` 'include' | 'exclude': Defines the types of SDK selection rules that can be applied to proxy profiles.
    - `productIdFilter` string, uuid, nullable: Defines the filter for matching Products by their unique identifier.
    - `configIdFilter` string, uuid, nullable: Defines the filter for matching Configs by their unique identifier.
    - `environmentIdFilter` string, uuid, nullable: Defines the filter for matching Environments by their unique identifier.
    - `productNameMatchFilter` string, nullable: Specifies a filter to match Product names in the proxy profile selection rule. It accepts wildcards (*).
    - `configNameMatchFilter` string, nullable: Specifies a filter to match Config names in the proxy profile selection rule. It accepts wildcards (*).
    - `environmentNameMatchFilter` string, nullable: Specifies a filter to match Environment names in the proxy profile selection rule. It accepts wildcards (*).

## Response `201`

When the creation was successful.

- ProxyProfileModel
  - `proxyProfileId` string, uuid, required: The unique identifier of the proxy profile.
  - `name` string, required: The name of the proxy profile.
  - `description` string, nullable, required: The description of the proxy profile.
  - `lastAccessedAt` string, date-time, nullable, required: The date and time when the proxy profile was last accessed.
  - `connectionPreferences` ConnectionPreferences, required: The connection preferences for the proxy profile, including SDK poll interval and webhook proxy URL.
    - `sdkPollInterval` integer, required: The SDK poll interval in seconds that determines how often SDKs should fetch config JSON updates.
    - `webhookNotification` WebhookNotification, required: The webhook notification settings, including the proxy URL and signing keys.
      - `webhookProxyUrl` string, required: The webhook proxy URL for receiving config JSON change notifications.
      - `signingKey1` string, required: The primary signing key used for verifying the authenticity of webhook requests.
      - `signingKey2` string, nullable, required: The secondary signing key used for verifying the authenticity of webhook requests.
  - `sdkKeySelectionRules` ProxyProfileSelectionRule[], required
    - `kind` 'include' | 'exclude', required: Defines the types of SDK selection rules that can be applied to proxy profiles.
    - `productIdFilter` string, uuid, nullable, required: Defines the filter for matching Products by their unique identifier.
    - `configIdFilter` string, uuid, nullable, required: Defines the filter for matching Configs by their unique identifier.
    - `environmentIdFilter` string, uuid, nullable, required: Defines the filter for matching Environments by their unique identifier.
    - `productNameMatchFilter` string, nullable, required: Specifies a filter to match Product names in the proxy profile selection rule. It accepts wildcards (*).
    - `configNameMatchFilter` string, nullable, required: Specifies a filter to match Config names in the proxy profile selection rule. It accepts wildcards (*).
    - `environmentNameMatchFilter` string, nullable, required: Specifies a filter to match Environment names in the proxy profile selection rule. It accepts wildcards (*).

## Other responses

- `400`: Bad request.
- `404`: Not found.
- `429`: Too many requests. In case of the request rate exceeds the rate limits.

## Changes

- **2025-11-20** `c45d8854233a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/configcat/apis/configcat-public-management-api/changes/v1/organizations/:organizationId/proxy-profiles/post.md)

---

[API](https://skmtc.dev/configcat/apis/configcat-public-management-api.md) - [All operations](https://skmtc.dev/configcat/apis/configcat-public-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/configcat/apis/configcat-public-management-api/revisions/0f143561d265?raw)