Application Permissions

This page covers the various application permissions made available for app developers. The permissions below can be easily assigned to an application by adding them to the app’s manifest file.

In combination with an App Access Token, these permissions authorize apps during server-to-server communication.

The permissions listed under Controlled Permissions are only available at the discretion of Speakap and cannot be added to your manifests.

Permissions

access_statistics

This permission grants application access to various network usage statistics such as number of pending/activated users, users sessions.

get_network_timeline

With this permission applications are able to retrieve the network timeline, containing only those messages sent to the whole network.

get_group_timelines

This permission grants application access to various network usage statistics such as number of pending/activated users, users sessions.

get_profiles

Applications with this permission have access to query user profiles, including user names, avatars, contact information, etc.

get_profile_status

Applications with this permission have access to query the status of user profiles. The status indicates whether the profile has been activated, deleted, etc.

view_user_activity

Applications with this permission can view aggregated data about users activities in the network.

CUSTOM-NOTE

No personal information about the user is revealed.

get_profile_xid

These permissions let applications retrieve the external identifier of user profiles. This identifier (XID) can be used to synchronize profile data with an external source.

get_user_groups

Applications with this permission can retrieve the groups a user is member of.

infinite_limit

In combination with content type minimal+json this can be used by applications to retrieve a limitless collection. This is convenient, for example, when you want to have returned all network groups in a single response.

invite_users

These permissions give applications the ability to invite users to the network.

list_groups

These permissions give applications the ability to discover all networks groups through the groups collection.

list_group_members

Add this permission to your application’s manifest to get an overview of all users who are member of a particular group.

post_to_any_group

By default, applications can only post to the network timeline or a user’s personal timeline. These permissions let you post updates to any of the groups in a network.

post_updates

Applications with this permission can post updates on timelines.

send_alerts

Applications with this permission can send alerts to users.

upload_files

Give your application permission to upload files by adding this permission to its manifest.

upload_into_folders

Applications with this permission can specify a destination folder when uploading files.

CUSTOM-NOTE

Only useful in combination with upload_files permission.

Controlled Permissions

edit_network_features

This permission gives applications the ability to change the features that are enabled for a network.

edit_network_subscription

This permission gives applications the ability to change the subscription status of a network.

list_networks

This permission gives applications the ability to discover all available networks through the networks collection.