Key questions about this property
The answers below summarize the purpose, scope, default effect, and review scenarios for this property.
| What does it do? |
Sets the lead time, in seconds, for refreshing email OAuth access tokens before they expire; the default is 300 seconds when the setting is missing or invalid. |
| What area does it affect? |
Email OAuth authentication |
| What does the default mean? |
No out of the box record exists and the scripts that read it pass no fallback value. |
| When should you review it? |
Review when adjusting how early email OAuth access tokens refresh before expiration. |
Property record
No out of the box record exists. ServiceNow scripts read this property; create it to change the behavior.
| Property name |
glide.mail.oauth2.access_token.refresh_before_expiry |
| Type |
Not stated |
| Application |
Not stated |
| Default value |
Not set |
| Description |
Not stated |
Sources
Official references and nearby text excerpts where this property appears.
Used in
Out of the box artefacts that read this property. Append the path to your instance URL to open the record and see how the value is used.
Script include: EmailClientAddOnOAuthHelper
The property sets how many seconds before an email add-on access token expires a proactive refresh is triggered. If unset or not a valid number, the code uses 300 seconds; the code does not show a separate user or admin setting beyond this timing behavior.
/sys_script_include.do?sys_id=aff40b0bff1903103395ffffffffff15
Script include: EmailOAuthHelper
The property sets how many seconds before an email OAuth access token expires the system attempts to refresh it; admins can adjust this timing, and invalid values use the 300-second default.
/sys_script_include.do?sys_id=52d69ceaeb233100469a20425206feb6
Script include: UserEmailOAuthHelper
The system reads this setting to determine how many seconds before an email access token expires it should try to refresh it, letting admins adjust the refresh timing for affected users. If the setting is missing or invalid, it uses 300 seconds (five minutes).
/sys_script_include.do?sys_id=6309a8f2ff01221067a4ffffffffffd1
More in glide (other)
Other properties in the same namespace.
All 537 properties in glide (other) →