---
title: "Create a new DNI settings record entry"
method: POST
path: "/callflow/dni"
tags: ["callflow"]
---

# Create a new DNI settings record entry

`POST /callflow/dni`

Creates Dynamic Number Insertion settings for call flows to enable web visitor-level call tracking. Configures number pools and insertion parameters that dynamically display different tracking numbers to website visitors based on their session.

## Request body

- DniSetting[]
  - `dni_code` string — Unique randomly generated ID key. Type: string.
  - `custom_cookie` string — Optional additional parameters. Type: string.
  - `group_id` integer, required — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.
  - `destination_url` string, required — The domain of the intended destination. Type: string.
  - `dni_type` 'session' | 'single' | 'URL' | 'url' | 'Source' | 'source', required — Specifies the type of DNI being used for this configuration. Type: enum (string); Allowed values: session, single, URL, url, Source, source.
  - `dni_element` string, required — The HTML element which is used for the DNI operation. Type: string.
  - `call_flow_id` integer, required — Unique identifier for the call flow/route definition the call was answered by. Integer. Maps to call_flow.call_flow_id.
  - `referrer` string, required — The domain from which the page was referred from. Type: string.
  - `referrer_type` string — Specifies the type of referrer used. Type: string.
  - `TTL` integer — Time to Live in minutes Max - 525,600 min. Type: integer (int32).

## Response `200`

Created DNI setting IDs with confirmation status for each configuration

- StandardPostResponse[]
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `data` string, required — Response payload. Shape varies by endpoint.
  - `entry_count` integer, required — The sequential number of the entry in the submitted array. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

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