Docs / Set it up
Telnyx setup: overview
Telnyx is the account that answers your building's phone call. This section walks through every click, with screenshots, in six short steps.
Telnyx answers your building's call and presses the unlock digit when someone taps Open door. It's the longest part of setup, so it's split into six short pages.
What you will end up with
By the end you will have four values to give to Knock, and a working phone number:
| What | Where it comes from | Knock setting |
|---|---|---|
| A phone number | You buy it in Telnyx | TELNYX_NUMBER |
| The application ID | Created with the Call Control app | TELNYX_CONNECTION_ID |
| An API key | Telnyx account settings | TELNYX_API_KEY |
| A public key | Telnyx account settings | TELNYX_PUBLIC_KEY |
The six steps
- Create and verify your account (5 min)
- Upgrade to Paid (5 min, about $5 of credit). Do not skip this.
- Buy a phone number (2 min)
- Create the Call Control app (4 min)
- Get your keys (3 min)
- Give the keys to Knock (3 min)
Seen in the wild
The Telnyx portal changes its menu layout from time to time. If a menu item isn't where this guide says, use the search icon at the top right of the portal and type what you need: "buy numbers", "API keys", "outbound voice profiles". Screenshots here were taken in November 2026.
Keep your secrets out of chat and email
You will handle an API key. Telnyx shows it once. Paste it straight into Vercel and nowhere else. Never send it to anyone, and never put it in a screenshot.