Create a Webhook Subscription | Latitude

Creates a new webhook subscription for the given URL and event types

This endpoint expects an object.

urlstringRequired

Customer provided webhook URL

event_typeslist of enumsRequired

Event types to subscribe to

Create a Webhook Subscription

idstring

Unique public identifier for the webhook subscription

urlstring

URL where webhook events are delivered

event_typeslist of enums

Event types this subscription receives

is_activeboolean

Whether the subscription is active

created_atstringformat: "date-time"

ISO 8601 timestamp when the subscription was created

updated_atstringformat: "date-time"

ISO 8601 timestamp when the subscription was last updated

400

Bad Request Error

1	import requests
2
3	url = "https://api.latitude.xyz/v1/webhook_subscriptions"
4
5	payload = {
6	"url": "https://webhooks.example.com/latitude-events",
7	"event_types": ["transfer.created", "transfer.completed", "conversion.completed"]
8	}
9	headers = {"Content-Type": "application/json"}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3	"url": "https://webhooks.example.com/latitude-events",
4	"event_types": [
5	"transfer.created",
6	"transfer.completed",
7	"conversion.completed"
8	],
9	"is_active": true,
10	"created_at": "2024-01-15T09:30:00Z",
11	"updated_at": "2024-01-15T09:30:00Z"
12	}