DIDHub Docs

Appearance

Changelog ​

Latest API, dashboard, and platform changes. We email significant changes (new endpoints, breaking changes, deprecations) to active API-key holders.

Versioning

The API is versioned in the path (/v1). Additive changes (new endpoints, new optional fields, new enum values) ship without a version bump. Breaking changes get a new version with a deprecation window. See Authentication for the auth surfaces.

2026-05 ​

OAuth 2.0 — authorize third-party apps ​

  • DIDHub is now an OAuth 2.0 Authorization Server. Build an app that DIDHub users sign into with their own account using Authorization Code + PKCE.
  • Register apps at Dashboard → Settings → OAuth apps; manage connected apps and disconnect from the same screen.
  • Endpoints: /oauth2/authorize, /oauth2/token, /oauth2/revoke, and RFC 8414 discovery at /.well-known/oauth-authorization-server.
  • Granular scopes (numbers:read, cdrs:read, etc.); refresh-token rotation with replay detection.
  • Full guide: Authentication → OAuth 2.0.

Compliance Center ​

  • Manage the end-users, identity documents, and regulatory bundles required for numbers in regulated countries — via the dashboard or the API (/v1/compliance/*).
  • Attach an approved bundle to a number to move it from pending_documents → active.

Routing profiles ​

  • Named call-routing policies with failover, round-robin, weighted, and simultaneous-ring strategies, composed of SIP-trunk / PSTN-forward / webhook targets.
  • API: /v1/routing-profiles/*. Attach to a number via PATCH /v1/numbers/{e164}.

Call Detail Records (CDRs) ​

  • Read-only call history at /v1/cdrs with duration, hangup cause, SIP response code, and the per-call customer charge. Filter by direction, number, and date range.

Billing — saved cards + auto-recharge ​

  • Save a card once and enable auto-recharge: when your balance drops below a threshold, DIDHub tops it up off-session against your default card.
  • API under /v1/billing/payment-methods/* and /v1/billing/auto-recharge.
  • Passwordless login by email link, alongside password and Google/Microsoft SSO. Honors MFA.

Cart + atomic checkout ​

  • KV-backed shopping cart that survives logout/device switches; POST /v1/cart/checkout provisions everything as a batch and returns per-item outcomes.

2026-04 — Foundation ​

  • API stable at https://api.didhub.io/v1.
  • Number provisioning in 130+ countries via the dashboard and the API.
  • Microsoft Teams Direct Routing — managed SBC-as-a-Service in 5 PowerShell commands.
  • AI voice-agent integrations (Vapi, Retell, ElevenLabs, Bland, Synthflow, LiveKit, Pipecat, Vocode, Cartesia, Deepgram, AssemblyAI, OpenAI Realtime).

On the roadmap ​

  • Customer webhooks — HMAC-signed event push for inbound SMS, call events, and port status. See Webhooks for the planned event catalog. (In development — not yet available.)
  • Auto-generated API spec — the OpenAPI document will be generated from the Worker's route definitions so it never drifts from the live API.
  • Programmatic API keys (GA) — key issuance + revocation ship today; full request-time authentication is rolling out. Contact support to enable for your account.

Want change notifications?

We email significant changes to active API-key holders. Manage subscriptions in Dashboard → Settings → Communications.

Last updated: