Update DNI Setting

Updates an existing Dynamic Number Insertion (DNI) setting.

Access Control

Requires valid JWT authentication

User must have access to the specified group and provisioned route

DNI setting must exist and be active

Provisioned route must be active

Behavior

Updates the DNI setting with provided values

Updates custom_params in dni_org_unit if custom_cookie is provided

For number pools with TTL, updates phone_pool keep_alive_mins

Sets dni_setting_modified to current timestamp

DNI Types

session: Typically used for number pools

source: Typically used for tracking numbers

url: Typically used for tracking numbers with lmc_track element

Required Fields

org_unit_id — Org unit ID

provisioned_route_id — Tracking number or number pool ID

destination_url — Host domain (e.g., example.com)

dni_type — DNI type (session/source/url)

dni_element — CSS selector/HTML class (e.g., .phone-number)

referrer — Referring website (e.g., google.com)

Optional Fields

dni_setting_name — Display name for this DNI configuration

referrer_type — paid/organic (only for Google/Yahoo)

custom_cookie — Custom tracking parameters

identifier — Text placeholder to replace with tracking number

dni_keywords — Keywords for categorization

dni_number_format — Phone number display format

TTL — Time to live in minutes (only for number pools)

Validation Rules

destination_url and referrer must be valid domain format

dni_element for 'url' type must be 'lmc_track'

dni_element for 'session'/'source' cannot be 'lmc_track' or empty

referrer_type (paid/organic) only applies to Google or Yahoo referrers

TTL must be between 1 and 525600 minutes (optional field)

Referrer-element-destination combination must be unique (excluding current setting)

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --globoff --request PUT 'https://platform-api.convirza.com/v3/dni/{dni_setting_id}' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "dni_setting_name": "Google Paid Campaign - Updated", "org_unit_id": 70035, "provisioned_route_id": 123, "destination_url": "example.com", "dni_type": "source", "dni_element": ".phone-number-updated", "referrer": "google.com", "referrer_type": "paid", "custom_cookie": "utm_source,utm_campaign,utm_medium", "identifier": "PHONE_NUMBER", "dni_keywords": "google,paid,ppc,updated", "dni_number_format": "(xxx) xxx-xxxx" }'

{ "code": 200, "message": "success", "request_id": "550e8400-e29b-41d4-a716-446655440000", "timestamp": "2026-04-22T10:30:00.000Z", "data": { "message": "DNI setting updated successfully" } }

Update DNI Setting

Request

Responses