Hosted Voice API

Getting Started

Credentials, authorization, conventions, and rate limits

Overview

Comprehensive reference for building integrations with the Hosted Voice platform. Three credentials are required for every request: Access Token, Domain Name, and Service ID. Base URL: https://n8n2.atomcomm.com/webhook/hostedvoice. All requests must be made over HTTPS.

Credentials

Access Token — found in the Atomic portal under Profile > Settings.

Service ID — found under Services > Voice (starts with 999).

Domain Name — found in the Config menu > Hosted Voice tab (format: xxxx.voice.atomcomm.com).

Authorization

All three headers are required on every request.

Required Headers

{
  "Authorization": "{{access_token}}",
  "Domain-Name": "{{domain_name}}",
  "service_id": "{{service_id}}"
}

Conventions

Field names use snake_case. Timestamps are ISO 8601 in UTC. Empty values are represented as null instead of empty strings. An "extension" refers to a user extension with a license. A "group" refers to an Auto Attendant, Hunt Group, or similar entity. "User" encompasses both extensions and groups.

Rate Limiting

Requests are limited to 10 per second on average. When the limit is exceeded the API returns HTTP 429 with a Retry-After header. A queue-based backoff strategy is recommended.

Back to API Documentation