Postman collection
Use Postman to try the AvenPing API without writing code. The collection matches the endpoints described in the HTTP API v2 docs (overview plus group pages).
Download
Use the link below to download the latest collection file to your computer, then import it into Postman.
Download AvenPing API v2 (Postman collection)
The file name is avenping-api.postman_collection.json. Your browser may save it to your Downloads folder.
Import and set up
- Open Postman (desktop or web) and choose Import.
- Drag the downloaded file in, or use Upload Files and select
avenping-api.postman_collection.json. - Select the AvenPing API v2 collection, open the Variables tab, and set:
| Variable | What to enter |
|---|---|
baseUrl | Your API base URL, e.g. https://api.avenping.com (no trailing slash) |
apiToken | Your token from the AvenPing app: Settings → API Settings |
phoneNumberId | Meta Phone number ID for the line you send from (see below) |
templateName, flowId, mediaId | Fill in when you run those example requests |
- To find valid
phoneNumberIdvalues, callGET /v2/mewith the same token (Bearer orX-API-Token). Copy aphoneNumberIdfrom thephoneNumbersarray into the collection variable. IfdefaultPhoneNumberIdis present, you have a single line and can use that value. - Under Public, run Health (
GET /v2/health) to confirmbaseUrlis correct. - For authenticated requests, the collection uses Bearer auth with
. There is also an example request that sends the token asX-API-Tokeninstead—either style works with the API.
Protect your token
Your API token is secret. Do not paste it into public chats, screenshots, or shared collection files. In Postman, prefer a private environment for apiToken so it is not embedded when you export the collection.
Optional: publish your own doc on Postman
You can turn this collection into a public documentation page (and optionally a “Run in Postman” button) for your team or customers:
- Create or sign in to a Postman account.
- Import the collection into a workspace.
- Optionally add Environments (for example Production vs staging) with different
baseUrlvalues. - Open the collection, then use View documentation or Publish (the exact label depends on your Postman version).
- Follow the steps to get a shareable URL. Anyone with the link can read the docs; they still need their own AvenPing token to call the API.
- When AvenPing adds or changes endpoints, download a fresh collection from this page, import it again, and republish so your public doc stays current.
Team accounts can use a Team workspace so several people can maintain the same collection and publishing settings.