Webhooks for Certificate Transparency

Webhooks for Certificate Transparency allows you to receive information in real-time for your domain's certificates by registering a Webhook and defining the domains you wish to monitor. Every time we detect a new certificate issued for these domains, we'll send a notification to your callback URL with information about the certificate. See the Certificate Transparency documentation for more information.

To set up Webhooks for Certificate Transparency:

  1. Configure the Webhook
  2. Subscribe to a New Domain.

Configure the Webhook

Use our Getting Started guide to create your endpoint and configure the Webhooks product. During configuration, make sure to choose the Certificate Transparency object and subscribe to the certificate field.

Sample Notification

[
  {
    "entry": [
      {
        "id": "1381739901945384",
        "changed_fields": [
          "certificate"
        ],
        "time": 1510160948
      }
    ],
    "object": "certificate_transparency"
  }
]
    

Subscribe to a New Domain

You can subscribe to a new domain by sending a POST request to the subscribed_domains edge with the subscribe field.

Sample Request

POST graph.facebook.com/110336783009523/subscribed_domains
  ?subscribe=["*.facebook.com"]
  &access_token=your-app-access-token

Sample Response

{
  "success": "true"
}

Subscribed Domains

You can see your subscribed domains by sending a GET request to the subscribed_domains edge. If you include the fields=domain parameter, the response will display actual domain names.

Sample Request

GET graph.intern.facebook.com/110336783009523/subscribed_domains
  ?fields=domain&access_token=your-app-access-token

Sample Response

{
  "data": [
    {
      "domain": "facebook.com",
      "id": "1567436076683534"
    }
  ],   
}