Skip to content

API Examples

Before using the API, please first create an API key here.

cURL

Quick upload file to Token

Uploads the file example.png from the current directory.

curl -F 'file=@example.png' https://webhook.site/00000000-0000-0000-0000-000000000000

To download the file, click the Download link in the Webhook.site interface, or via the API, use the download endpoint.

PHP

Create Token (URL/Email address)

Creates a Webhook.site Token and outputs its Web URL. You'll need to replace the API key.

<?php
$apiKey = '00000000-0000-0000-0000-000000000000';

// Create a stream context
$context = stream_context_create(['http' => [
    'method' => 'POST',
    'header' => "Api-Key: $apiKey\r\n"
]]);

// Send API request
$response = json_decode(file_get_contents('https://webhook.site/token', false, $context), true);

echo "URL Created: https://webhook.site/{$response['uuid']}";

Fetch latest data

Simple example of how to loop through the latest requests or emails sent to a Webhook.site URL or email and display in a friendly manner.

You'll need to replace the API key and token ID.

<?php
$apiKey = '00000000-0000-0000-0000-000000000000';
$tokenId = '00000000-0000-0000-0000-000000000000';

$url = "https://webhook.site/token/$tokenId/requests?sorting=newest";

$context = stream_context_create(['http' => ['header' => "Api-Key: $apiKey\r\n"]]);

$response = json_decode(file_get_contents($url, false, $context), true);

foreach ($response['data'] as $req) {
    echo "\n";
    echo "ID        : {$req['uuid']}\n";
    echo "Type      : {$req['type']}\n";
    echo "Date      : {$req['created_at']}\n";
    echo "User-Agent: {$req['headers']['user-agent'][0] ?? 'Unknown'}\n";
    echo "--- content begin ---\n";
    echo $req['content'];
    echo "\n--- content end ---\n";
}

Example output after running e.g. curl -X POST https://webhook.site/00000000-0000-0000-0000-000000000000 -d "Hello world":

ID        : 58980c49-7e09-4cd8-8d64-bbfcfc38a1c5
Type      : web
Date      : 2021-12-01 19:24:10
User-Agent: Paw/3.3.1 (Macintosh; OS X/11.6.0) GCDHTTPRequest
--- content begin ---
Hello world!
--- content end ---

Python

Create Token (URL/Email address)

Requires the requests module, which can be installed using pip install requests.

You'll also need to replace the API key.

import requests

json = {
  "default_status": 200,
  "default_content": "Hello world!",
  "default_content_type": "text/html",
}

headers = {
    "api-key": "00000000-0000-0000-0000-000000000000"
}

r = requests.post('https://webhook.site/token', json=json, headers=headers)

print('URL Created: https://webhook.site/' + r.json()['uuid'])

Fetch latest data

Requires the requests module, which can be installed using pip install requests.

Prints the 50 latest requests sent to a given URL to console.

import requests

token_id = "00000000-0000-0000-0000-000000000000"
headers = {"api-key": "00000000-0000-0000-0000-000000000000"}

r = requests.get('https://webhook.site/token/'+ token_id +'/requests?sorting=newest', headers=headers)

for request in r.json()['data']:
    print(request)