Docs/Build/Use Voyced with Postman

Use Voyced with Postman

Import the Voyced collection and Sandbox environment, add credentials in the correct fields and run the requests in order.

Keep credentials private

Use a personal or controlled Postman workspace. Keep credential values local and marked as sensitive. Never export or share an environment after adding real credentials.

Read the security checklist

Postman does not prompt for values after import

Import both files, select Voyced Sandbox, then open that environment and enter the key and secret yourself.

Download this first

Voyced Postman Sandbox starter bundleCollection, Sandbox environment and START-HERE guide in one ZIP

Download ZIP

Set it up

Import both JSON files

Extract the ZIP. In Postman, select Import and choose both JSON files.

Select Voyced Sandbox

Choose Voyced Sandbox in Postman's environment selector. Do this before opening or running a request.

Enter the credentials in the environment

Open Environments → Voyced Sandbox. The URL is already filled in. Add your key and secret in the local value fields, then save.

Variable	What to enter
`base_url`	Already set to `https://sandbox.voycedconnect.eu/v1`
`api_key`	Your Sandbox API key
`api_secret`	Your Sandbox API secret
`access_token`	Leave empty. Request 1 fills this automatically.
`telephone_number`	Add an active number after running the telephone numbers request.
`queue_id`	Add a returned queue ID before running one-queue requests.
`ivr_id`	Add a returned IVR ID before running one-IVR requests.

Keep the values local and secure

Set api_key, api_secret and access_token as sensitive local values. Do not use shared values and do not export the environment after adding credentials.

Run 1. Request bearer token

The test script stores the returned bearer token in access_token. Later requests use it automatically.

Run the read requests in order

Start with Test connection and Capabilities. Then list numbers, queues and IVRs before filling their ID variables.

Review write requests before sending

Follow-Me, queue and IVR update requests contain example bodies. Replace the examples with values from your own Sandbox results.

Move to Live

After Sandbox testing and approval, import the Live environment, select it, enter the separate Live credentials and request a new token. Never copy a Sandbox token into the Live environment.

Collection JSON on its own is not enough

The collection contains placeholders. The separate environment provides the URL and the fields where credentials belong.