Add phone numbers to a TFN profile

Idempotent add — numbers already attached are ignored. Numbers appended to an approved profile trigger incremental verification against that profile; each number receives its own verification decision.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
phone_numbers
array of strings
required
length between 1 and 1000

E.164 numbers to add. Idempotent — already-associated numbers are ignored.

phone_numbers*
Headers
string
length ≤ 255

Any unique string (e.g. a UUID). Retries with the same key within 24h return the original response with Idempotent-Replayed: true. Same key + different body → 409.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json