Skip to main content

Prerequisites

  • An active telephony credential

Create a Token

The following API request will generate a JWT.
This JWT is valid until:
  • 24 hours after its creation or
  • the parent telephony credential is expired
whichever comes first

What a JWT Represents

A JWT is an authentication token for one telephony credential. It does not create a new SIP identity. Best practices:
  • JWTs minted from the same telephony credential still represent the same sip_username (gencred...)
  • Create a separate telephony credential per device, then mint JWTs from that credential

Immediate Login After Credential Creation

If you create a telephony credential and mint a JWT from it, wait about 5 seconds before using either the gencred or the JWT for login. Using them immediately after creation can fail transiently while the credential propagates.

SDK Authentication

SDKs are authenticated with the JWT.

Check SIP Registration Status

If you need to confirm whether the SDK is currently registered, use the underlying telephony credential’s sip_username (gencred...) with the SIP Registration Status endpoint.

Limits

Currently, there exists
  • No limit on count of tokens on a telephony credential,
  • Nor any limit on the aggregate count of tokens on a single account.

Additional Resources