Create a webhook

POST

https://api.smallest.ai/atoms/v1/webhook

Create a new webhook with subscriptions for specific agents and events.

400 is also returned when the endpoint URL is already registered: "A webhook with this URL has already been registered"

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

This endpoint expects an object.

endpointstringRequired

The webhook endpoint URL

descriptionstringRequired

The description of the webhook

eventslist of objectsRequired

Array of events to subscribe to

Webhook created successfully

statusboolean

datastring

The ID of the created webhook

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	from smallestai import SmallestAI
2	from smallestai.atoms.webhooks import PostWebhookRequestEventsItem
3
4	client = SmallestAI(
5	token="YOUR_TOKEN_HERE",
6	)
7
8	client.atoms.webhooks.create_a_webhook(
9	endpoint="https://example.com/webhook",
10	description="Webhook for conversation events",
11	events=[
12	PostWebhookRequestEventsItem(
13	agent_id="60d0fe4f5311236168a109ca",
14	event_type="post-conversation",
15	)
16	],
17	)