/threat_privacy_groups

This API call enables the creation of a ThreatPrivacyGroup via an HTTP POST request. Privacy groups can be used to protect uploaded data. This feature is only available in versions 2.4+ of the Graph API.

Parameters

The following query parameters are available (bold parameters are required):

• access_token - The key for authenticating to the API. It is a concatenation of <your-app-id>|<your-app-secret>. For example, if our app ID was 555 and our app secret aSdF123GhK, our access_token would be "555|aSdF123GhK".
• name - The name of the threat privacy group.
• description - A human readable description of the group.
• members - A list of ThreatExchangeMembers to be added to the group. Can be modified later.
• members_can_see - If true, group members can view this group, including its name, description, and list of members. Defaults to FALSE.
• members_can_use - If true, members are allowed to use this group to protect their own threat data. Defaults to FALSE.
• fields - A list of fields to return in the response

Sample Usage

To create a privacy group, one could POST to:

https://graph.facebook.com/v2.5/threat_privacy_groups?name=GROUP1&description=MYFIRSTGROUP&members_can_see=TRUE&access_token=555|asdF123

Data returned:

{
  "id": "123456789101112"
}

To change the members list for that privacy group, POST to the corresponding node (this can be used to either add or remove members from the group):

https://graph.facebook.com/v2.4/123456789101112?members=820763734618599,<another-app-id>

Data returned:

{
  "success": true
}