Graph API Version

ThreatPrivacyGroup

A list of ThreatExchangeMembers to which data can be shared, maintained by the owner of the group, sometimes referred to as the "admin". The membership of a group can be changed over time, and is generally the preferred way to share data on ThreatExchange.

Additional features can be unlocked for a ThreatPrivacyGroup, such as the threat_updates API, or a listing on the Home tab of the ThreatExchange UI by reaching out to threatexchange@meta.com.

Fields

Parameter	Description	Type
`id`	Unique identifier of the threat privacy group	`number`
`name`	The name of the threat privacy group	`string`
`description`	A human readable description of the group	`string`
`members_can_see`	If true, group members can see the list of members	`boolean`
`members_can_use`	If true, members are allowed to share their own data via this PrivacyGroup	`boolean`

Sample Usage

To create a privacy group, one could POST to:

https://graph.facebook.com/v2.4/threat_privacy_groups?name=GROUP1&amp;description=MYFIRSTGROUP&amp;access_token=555|asdF123

Data returned:

{
  "id": "123456789101112"
}

Connections

Name	Description	Type
`members`	Members of the privacy group	`ThreatExchangeMember`

Sample Usage

Example query for a specific privacy group: 123456789101112

https://graph.facebook.com/v2.4/123456789101112/members/?access_token=555|aSdF123GhK

Data returned:

{
  "data": [
    {
      "id": "999999999999",
      "email": "threatexchange@domain.com",
      "name": "Facebook Administrator"
    }
    ...
  ]
}