By definition, a token is a unique identifier that is used to authenticate access to an API. You can think of it as a virtual passkey between Agorapulse and your social networks. In order to establish and maintain the permissions required to manage your social profiles in Agorapulse, we need to ensure there is always a valid token associated to each profile.
​
In this article, we will outline:

Tokens can become invalid or expire for reasons such as a password change on the relevant social network, a change in your role on a social profile, or an automatic expiration triggered by the social networks.
​
The token validity period for each social network is outlined below:

You can find a list of all tokens associated to your account in the Social profiles & tokens section of the Organization settings. To access these settings:

You can quickly identify the status of each token by using the status filter. You can filter by the following statuses:

From the Social profiles & tokens section:

If your token has been refreshed successfully, the token indicator should be highlighted in green. If the token indicator is still showing as red or yellow, the token has not been updated successfully.
​

Users require Owner or Manager level permissions in order to renew tokens in Agorapulse. Members who have been given access to Manage social profiles and Admin permissions on a specific profile may also renew tokens.

In addition to Agorapulse permissions, native permissions in the relevant social network are also required to renew a token. To assist with finding a user within your organization that has the relevant native permissions required to renew a token, you may view the See all managers pop-up. From the Social profiles & tokens section:

This will provide a list of managers within your organization. There will be three different options under the Can renew tokens heading:

The permissions required to renew a token vary depending on the relevant social network. We have outlined the permissions per network below:

Agorapulse can notify you about tokens that require renewal through several configurable notification methods. You will receive notifications 7 days, 3 days and 1 day before the token expiration date. You will also receive a notification when the token expires. These methods include:

You are able to configure notifications for token expiry in your Personal settings. In order to access these settings:

You may also access these settings from the Social profiles & tokens section:

Once you are on the Notifications menu, you may navigate to the Token expiration section and complete the following actions:

When clicking on an in-app token expiry notification, you will be taken to the Social profile & tokens settings, where you can follow these steps to renew the token. Keep in mind, you will still need the correct permissions to renew the token.

This will only appear for Admins on the relevant social profiles that are at risk. You may renew your tokens directly in the pop-up that appears upon log in.

When a token expires or is dropped, the connection between Agorapulse and the relevant social network is broken. While there is no valid token, you will not be able to sync information from the social network or publish items through Agorapulse.

Agorapulse can sync historical data once a token is reconnected, but you are at risk of losing data if there period in which the token was invalid exceed our historical sync limits. You can find more information on those limits here.