---
title: "Create a traffic policy profile"
method: POST
path: "/traffic/policy/profiles"
tags: ["Traffic Policy Profiles"]
---

# Create a traffic policy profile

`POST /traffic/policy/profiles`

Create a new traffic policy profile. At least one of `services`, `ip_ranges`, or `domains` must be provided.

## Request body

- object
  - `domains` string[] — Array of domain names.
  - `ip_ranges` string[] — Array of IP ranges in CIDR notation.
  - `limit_bw_kbps` 512 | 1024 — Bandwidth limit in kbps. Must be 512 or 1024.
  - `services` string[] — Array of PCEF service IDs to include in the profile.
  - `type` 'whitelist' | 'blacklist', required — The type of the traffic policy profile.

## Response `201`

Successful Response

- object
  - `data` TrafficPolicyProfile
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `domains` string[] — Array of domain names.
    - `id` string, uuid — Identifies the resource.
    - `ip_ranges` string[] — Array of IP ranges in CIDR notation.
    - `limit_bw_kbps` integer, nullable — Bandwidth limit in kbps.
    - `record_type` string
    - `services` string[] — Array of PCEF service IDs included in the profile.
    - `type` 'whitelist' | 'blacklist' | 'throttling' — The type of the traffic policy profile.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was updated.

## Other responses

- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/ec31f78cf002/schema)