Required: You must have a valid, authenticated Api User with the Call share role enabled. To request this role be enabled for you, email Tethr Support.
Guest user token API
URL
https://[INSTANCE NAME]/callshare/v1/token
Request
| Attribute | Type | Description |
|---|---|---|
| callID | string | Tethr call ID |
| string | The email address of the person accessing the call |
Response
| Attribute | Type | Description |
|---|---|---|
| callUrl | string | The target URL to access the shared call |
| expiration | date | When the request will expire (default is 8 hours) |
Example
POST https://[INSTANCE NAME]/callshare/v1/token
Authorization: Bearer [TOKEN]
Content-Type: application/json; charset=utf-8
{ "callId": "{CallId}", "email": "{EmailOfWhoWillBeAccessingTheCall}" }
Response
{ "callUrl": "{CallUrl}", "expiration": "{ExpirationDateTime}" }
Once the user navigates to the call URL
- They will be asked to either
- Sign up and create a password, or
- Log in with the created password if they already have signed up with that email.
- They will be redirected to the call.
Tip: The user accessing the link needs to own the provided email address in case any password reset or other account related messages are sent during the log in step.