Connect your BusinessPhoneSystem

Confirm your account details

Obtain your assigned hostname, A1PBX API key, and enabled API version. The examples use /app/api/7 and header authentication. Confirm both with A1ROUTES before use.

Start with call history

If call-history access is enabled, use a read request to check connectivity without initiating a call. Save your account identifier as A1PBX_ACCOUNT_ID and your key as A1PBX_API_KEY.

1curl --fail-with-body --get \
2  "https://$A1PBX_ACCOUNT_ID.a1routes.com/app/api/7/xml_cdr" \
3  --header "Authorization: Basic $A1PBX_API_KEY" \
4  --data-urlencode "limit=20" \
5  --data-urlencode "offset=0" \
6  --data-urlencode "order_by=start_epoch desc"

Choose a workflow

• Originate a call from an existing authorized extension.
• Find recordings and download audio.
• Read voicemail where mailbox access is enabled.

Keep access narrow

Request only the operations required for your integration. Mailbox and recording access must match the user's entitlement; account membership alone should not be assumed to grant access to every message.