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. These methods include:

More information on configuring these notifications is available in this the Agorapulse Notifications Explained article. ​

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.