Webhook subscriptions

Create and disable webhook subscriptions for Zapier and Make.com.

Last updated:

These endpoints are designed for automation providers, but you can also use them directly if you want Twentybaan to push events to your system. For how webhook payloads are signed and delivered, see the Webhooks guide.

POST/v1/providers/zapier/hooks/subscribe/

Subscribe (Zapier)

Create a new Zapier webhook subscription for one event.

Required attributes

Name
target_url
Type
string
Description
The URL that should receive webhook deliveries.
Name
event
Type
string
Description
Event name (for example listing.published).

Optional attributes

Name
zap_id
Type
string
Description
Provider reference id for debugging/traceability.

Required scope

OAuth tokens must include webhooks:manage.

Request

POST

/v1/providers/zapier/hooks/subscribe/

curl https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url":"https://example.com/webhooks/twentybaan","event":"listing.published"}'

POST

/v1/providers/zapier/hooks/subscribe/

const token = process.env.TWENTYBAAN_API_KEY;

const res = await fetch("https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    target_url: "https://example.com/webhooks/twentybaan",
    event: "listing.published",
  }),
});

if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

POST

/v1/providers/zapier/hooks/subscribe/

type TwentybaanWebhookSubscribeResponse =
  | { ok: true; id: number }
  | { ok: false; error: string };

const token = process.env.TWENTYBAAN_API_KEY!;

const res = await fetch("https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    target_url: "https://example.com/webhooks/twentybaan",
    event: "listing.published",
  }),
});

const data = (await res.json()) as TwentybaanWebhookSubscribeResponse;

if (!res.ok || !data.ok) {
  throw new Error("Request failed");
}

console.log(data.id);

POST

/v1/providers/zapier/hooks/subscribe/

import os
import requests

token = os.environ["TWENTYBAAN_API_KEY"]

res = requests.post(
  "https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/",
  json={
    "target_url": "https://example.com/webhooks/twentybaan",
    "event": "listing.published",
  },
  headers={
    "Accept": "application/json",
    "Authorization": f"Bearer {token}",
  },
  timeout=30,
)
res.raise_for_status()
print(res.json())

POST

/v1/providers/zapier/hooks/subscribe/

<?php

$token = getenv('TWENTYBAAN_API_KEY') ?: '';

$payload = json_encode([
  "target_url" => "https://example.com/webhooks/twentybaan",
  "event" => "listing.published",
], JSON_UNESCAPED_SLASHES);

$ch = curl_init("https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Content-Type: application/json",
    "Authorization: Bearer " . $token,
  ],
]);

$body = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP {$status}\n";
echo $body;

POST

/v1/providers/zapier/hooks/subscribe/

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var token = Environment.GetEnvironmentVariable("TWENTYBAAN_API_KEY") ?? "";

using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var payload = "{\"target_url\":\"https://example.com/webhooks/twentybaan\",\"event\":\"listing.published\"}";
using var content = new StringContent(payload, Encoding.UTF8, "application/json");

var res = await client.PostAsync("https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/", content);
var body = await res.Content.ReadAsStringAsync();

Console.WriteLine((int)res.StatusCode);
Console.WriteLine(body);

POST

/v1/providers/zapier/hooks/subscribe/

require "net/http"
require "json"

token = ENV.fetch("TWENTYBAAN_API_KEY")
uri = URI("https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/")

req = Net::HTTP::Post.new(uri)
req["Accept"] = "application/json"
req["Content-Type"] = "application/json"
req["Authorization"] = "Bearer #{token}"
req.body = {
  target_url: "https://example.com/webhooks/twentybaan",
  event: "listing.published",
}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(req)
end

puts res.code
puts res.body

POST

/v1/providers/zapier/hooks/subscribe/

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  token := os.Getenv("TWENTYBAAN_API_KEY")

  payload := []byte(`{"target_url":"https://example.com/webhooks/twentybaan","event":"listing.published"}`)
  req, err := http.NewRequest("POST", "https://api.twentybaan.com/v1/providers/zapier/hooks/subscribe/", bytes.NewBuffer(payload))
  if err != nil {
    panic(err)
  }

  req.Header.Set("Accept", "application/json")
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Authorization", "Bearer "+token)

  client := &http.Client{Timeout: 30 * time.Second}
  res, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()

  body, _ := io.ReadAll(res.Body)
  fmt.Println(res.Status)
  fmt.Println(string(body))
}

Response

{
  "ok": true,
  "id": 123
}

POST/v1/providers/zapier/hooks/unsubscribe/

Unsubscribe (Zapier)

Disable an existing Zapier webhook subscription by id.

Required attributes

Name
id
Type
integer
Description
The subscription id to disable.

Errors

Returns 404 if the subscription does not exist, is not owned by the user, or is not a Zapier subscription.

Request

POST

/v1/providers/zapier/hooks/unsubscribe/

curl https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":123}'

POST

/v1/providers/zapier/hooks/unsubscribe/

const token = process.env.TWENTYBAAN_API_KEY;

const res = await fetch("https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({ id: 123 }),
});

if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

POST

/v1/providers/zapier/hooks/unsubscribe/

type TwentybaanWebhookUnsubscribeResponse =
  | { ok: true }
  | { ok: false; error: string };

const token = process.env.TWENTYBAAN_API_KEY!;

const res = await fetch("https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({ id: 123 }),
});

const data = (await res.json()) as TwentybaanWebhookUnsubscribeResponse;

if (!res.ok || !data.ok) {
  throw new Error("Request failed");
}

console.log(data);

POST

/v1/providers/zapier/hooks/unsubscribe/

import os
import requests

token = os.environ["TWENTYBAAN_API_KEY"]

res = requests.post(
  "https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/",
  json={"id": 123},
  headers={
    "Accept": "application/json",
    "Authorization": f"Bearer {token}",
  },
  timeout=30,
)
res.raise_for_status()
print(res.json())

POST

/v1/providers/zapier/hooks/unsubscribe/

<?php

$token = getenv('TWENTYBAAN_API_KEY') ?: '';

$payload = json_encode([
  "id" => 123,
], JSON_UNESCAPED_SLASHES);

$ch = curl_init("https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Content-Type: application/json",
    "Authorization: Bearer " . $token,
  ],
]);

$body = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP {$status}\n";
echo $body;

POST

/v1/providers/zapier/hooks/unsubscribe/

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var token = Environment.GetEnvironmentVariable("TWENTYBAAN_API_KEY") ?? "";

using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var payload = "{\"id\":123}";
using var content = new StringContent(payload, Encoding.UTF8, "application/json");

var res = await client.PostAsync("https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/", content);
var body = await res.Content.ReadAsStringAsync();

Console.WriteLine((int)res.StatusCode);
Console.WriteLine(body);

POST

/v1/providers/zapier/hooks/unsubscribe/

require "net/http"
require "json"

token = ENV.fetch("TWENTYBAAN_API_KEY")
uri = URI("https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/")

req = Net::HTTP::Post.new(uri)
req["Accept"] = "application/json"
req["Content-Type"] = "application/json"
req["Authorization"] = "Bearer #{token}"
req.body = { id: 123 }.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(req)
end

puts res.code
puts res.body

POST

/v1/providers/zapier/hooks/unsubscribe/

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  token := os.Getenv("TWENTYBAAN_API_KEY")

  payload := []byte(`{"id":123}`)
  req, err := http.NewRequest("POST", "https://api.twentybaan.com/v1/providers/zapier/hooks/unsubscribe/", bytes.NewBuffer(payload))
  if err != nil {
    panic(err)
  }

  req.Header.Set("Accept", "application/json")
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Authorization", "Bearer "+token)

  client := &http.Client{Timeout: 30 * time.Second}
  res, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()

  body, _ := io.ReadAll(res.Body)
  fmt.Println(res.Status)
  fmt.Println(string(body))
}

Response

{
  "ok": true
}

POST/v1/providers/make/hooks/subscribe/

Subscribe (Make.com)

Create a new Make.com webhook subscription for one event.

Required attributes

Name
target_url
Type
string
Description
The URL that should receive webhook deliveries.
Name
event
Type
string
Description
Event name (for example contact_message.created).

Optional attributes

Name
scenario_id
Type
string
Description
Provider reference id for debugging/traceability.

Required scope

OAuth tokens must include webhooks:manage.

Request

POST

/v1/providers/make/hooks/subscribe/

curl https://api.twentybaan.com/v1/providers/make/hooks/subscribe/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url":"https://example.com/webhooks/twentybaan","event":"contact_message.created"}'

POST

/v1/providers/make/hooks/subscribe/

const token = process.env.TWENTYBAAN_API_KEY;

const res = await fetch("https://api.twentybaan.com/v1/providers/make/hooks/subscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    target_url: "https://example.com/webhooks/twentybaan",
    event: "contact_message.created",
  }),
});

if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

POST

/v1/providers/make/hooks/subscribe/

type TwentybaanWebhookSubscribeResponse =
  | { ok: true; id: number }
  | { ok: false; error: string };

const token = process.env.TWENTYBAAN_API_KEY!;

const res = await fetch("https://api.twentybaan.com/v1/providers/make/hooks/subscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    target_url: "https://example.com/webhooks/twentybaan",
    event: "contact_message.created",
  }),
});

const data = (await res.json()) as TwentybaanWebhookSubscribeResponse;

if (!res.ok || !data.ok) {
  throw new Error("Request failed");
}

console.log(data.id);

POST

/v1/providers/make/hooks/subscribe/

import os
import requests

token = os.environ["TWENTYBAAN_API_KEY"]

res = requests.post(
  "https://api.twentybaan.com/v1/providers/make/hooks/subscribe/",
  json={
    "target_url": "https://example.com/webhooks/twentybaan",
    "event": "contact_message.created",
  },
  headers={
    "Accept": "application/json",
    "Authorization": f"Bearer {token}",
  },
  timeout=30,
)
res.raise_for_status()
print(res.json())

POST

/v1/providers/make/hooks/subscribe/

<?php

$token = getenv('TWENTYBAAN_API_KEY') ?: '';

$payload = json_encode([
  "target_url" => "https://example.com/webhooks/twentybaan",
  "event" => "contact_message.created",
], JSON_UNESCAPED_SLASHES);

$ch = curl_init("https://api.twentybaan.com/v1/providers/make/hooks/subscribe/");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Content-Type: application/json",
    "Authorization: Bearer " . $token,
  ],
]);

$body = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP {$status}\n";
echo $body;

POST

/v1/providers/make/hooks/subscribe/

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var token = Environment.GetEnvironmentVariable("TWENTYBAAN_API_KEY") ?? "";

using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var payload = "{\"target_url\":\"https://example.com/webhooks/twentybaan\",\"event\":\"contact_message.created\"}";
using var content = new StringContent(payload, Encoding.UTF8, "application/json");

var res = await client.PostAsync("https://api.twentybaan.com/v1/providers/make/hooks/subscribe/", content);
var body = await res.Content.ReadAsStringAsync();

Console.WriteLine((int)res.StatusCode);
Console.WriteLine(body);

POST

/v1/providers/make/hooks/subscribe/

require "net/http"
require "json"

token = ENV.fetch("TWENTYBAAN_API_KEY")
uri = URI("https://api.twentybaan.com/v1/providers/make/hooks/subscribe/")

req = Net::HTTP::Post.new(uri)
req["Accept"] = "application/json"
req["Content-Type"] = "application/json"
req["Authorization"] = "Bearer #{token}"
req.body = {
  target_url: "https://example.com/webhooks/twentybaan",
  event: "contact_message.created",
}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(req)
end

puts res.code
puts res.body

POST

/v1/providers/make/hooks/subscribe/

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  token := os.Getenv("TWENTYBAAN_API_KEY")

  payload := []byte(`{"target_url":"https://example.com/webhooks/twentybaan","event":"contact_message.created"}`)
  req, err := http.NewRequest("POST", "https://api.twentybaan.com/v1/providers/make/hooks/subscribe/", bytes.NewBuffer(payload))
  if err != nil {
    panic(err)
  }

  req.Header.Set("Accept", "application/json")
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Authorization", "Bearer "+token)

  client := &http.Client{Timeout: 30 * time.Second}
  res, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()

  body, _ := io.ReadAll(res.Body)
  fmt.Println(res.Status)
  fmt.Println(string(body))
}

Response

{
  "ok": true,
  "id": 123
}

POST/v1/providers/make/hooks/unsubscribe/

Unsubscribe (Make.com)

Disable an existing Make.com webhook subscription by id.

Required attributes

Name
id
Type
integer
Description
The subscription id to disable.

Errors

Returns 404 if the subscription does not exist, is not owned by the user, or is not a Make subscription.

Request

POST

/v1/providers/make/hooks/unsubscribe/

curl https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":123}'

POST

/v1/providers/make/hooks/unsubscribe/

const token = process.env.TWENTYBAAN_API_KEY;

const res = await fetch("https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({ id: 123 }),
});

if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

POST

/v1/providers/make/hooks/unsubscribe/

type TwentybaanWebhookUnsubscribeResponse =
  | { ok: true }
  | { ok: false; error: string };

const token = process.env.TWENTYBAAN_API_KEY!;

const res = await fetch("https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({ id: 123 }),
});

const data = (await res.json()) as TwentybaanWebhookUnsubscribeResponse;

if (!res.ok || !data.ok) {
  throw new Error("Request failed");
}

console.log(data);

POST

/v1/providers/make/hooks/unsubscribe/

import os
import requests

token = os.environ["TWENTYBAAN_API_KEY"]

res = requests.post(
  "https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/",
  json={"id": 123},
  headers={
    "Accept": "application/json",
    "Authorization": f"Bearer {token}",
  },
  timeout=30,
)
res.raise_for_status()
print(res.json())

POST

/v1/providers/make/hooks/unsubscribe/

<?php

$token = getenv('TWENTYBAAN_API_KEY') ?: '';

$payload = json_encode([
  "id" => 123,
], JSON_UNESCAPED_SLASHES);

$ch = curl_init("https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Content-Type: application/json",
    "Authorization: Bearer " . $token,
  ],
]);

$body = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP {$status}\n";
echo $body;

POST

/v1/providers/make/hooks/unsubscribe/

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var token = Environment.GetEnvironmentVariable("TWENTYBAAN_API_KEY") ?? "";

using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var payload = "{\"id\":123}";
using var content = new StringContent(payload, Encoding.UTF8, "application/json");

var res = await client.PostAsync("https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/", content);
var body = await res.Content.ReadAsStringAsync();

Console.WriteLine((int)res.StatusCode);
Console.WriteLine(body);

POST

/v1/providers/make/hooks/unsubscribe/

require "net/http"
require "json"

token = ENV.fetch("TWENTYBAAN_API_KEY")
uri = URI("https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/")

req = Net::HTTP::Post.new(uri)
req["Accept"] = "application/json"
req["Content-Type"] = "application/json"
req["Authorization"] = "Bearer #{token}"
req.body = { id: 123 }.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(req)
end

puts res.code
puts res.body

POST

/v1/providers/make/hooks/unsubscribe/

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  token := os.Getenv("TWENTYBAAN_API_KEY")

  payload := []byte(`{"id":123}`)
  req, err := http.NewRequest("POST", "https://api.twentybaan.com/v1/providers/make/hooks/unsubscribe/", bytes.NewBuffer(payload))
  if err != nil {
    panic(err)
  }

  req.Header.Set("Accept", "application/json")
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Authorization", "Bearer "+token)

  client := &http.Client{Timeout: 30 * time.Second}
  res, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()

  body, _ := io.ReadAll(res.Body)
  fmt.Println(res.Status)
  fmt.Println(string(body))
}

Response

{
  "ok": true
}