Create a Webhook Subscription

POST https://api.slidespeak.co/api/v1/webhook/subscribe

Creates a webhook subscription that sends HTTP POST notifications to your specified endpoint when a presentation generation task completes. Use this to automate downstream workflows, trigger notifications, or integrate SlideSpeak with other systems. You can remove subscriptions with the Delete a Webhook Subscription endpoint.

Headers

---

Content-Type: string

application/json

X-API-Key: string

The API key to use for the request.
<YOUR_API_KEY>

Body Parameters

---

endpoint: string

The endpoint URL to receive the webhook.

Code Examples

---

cURL

curl -X POST https://api.slidespeak.co/api/v1/webhook/subscribe   -H "Content-Type: application/json"   -H "X-API-Key: <YOUR_API_KEY>"   -d '{
    "endpoint": "https://yourapp.com/webhook/presentation-generated"
}'

JavaScript

fetch('https://api.slidespeak.co/api/v1/webhook/subscribe', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '<YOUR_API_KEY>',
  },
  body: JSON.stringify({ endpoint: 'https://yourapp.com/webhook/presentation-generated' }),
}).then(response => response.json()).then(data => {
  console.log("Response:", data);
}).catch(error => {
  console.error("Error:", error);
});

Python

import requests

headers = {
    "Content-Type": "application/json",
    "X-API-Key": "<YOUR_API_KEY>"
}

payload = {
    "endpoint": "https://yourapp.com/webhook/presentation-generated"
}

response = requests.post("https://api.slidespeak.co/api/v1/webhook/subscribe", headers=headers, json=payload)
print(response.json())

PHP

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();

$response = $client->post('https://api.slidespeak.co/api/v1/webhook/subscribe', [
    'headers' => [
        'Content-Type' => 'application/json',
        'X-API-Key' => 'YOUR_API_KEY'
    ],
    'json' => [
        'endpoint' => 'https://yourapp.com/webhook/presentation-generated'
    ]
]);

$body = $response->getBody();
$data = json_decode($body, true);

print_r($data);

Response

---

201

{
    "webhook_id": "353509d6-8efe-401c-a8a9-53ca64b520a3"
}