Register a webhook endpoint with Projul AI Connect and Projul sends a signed JSON message to your address every time a chosen event happens, set up through the REST API rather than an AI assistant.
This is for someone building an automation; to have your AI report changes without registering an endpoint, see Copy-paste prompts: daily office admin.
Register an endpoint
POST to https://connect.projul.com/v1/webhook_endpoints with three headers: Authorization (Bearer plus your Read-Write key), Content-Type (application/json), and Idempotency-Key (any value), the address in url, and events in event_types. It must use https; Projul refuses http and private or internal addresses.
{
"url": "https://example.com/projul-hook",
"event_types": ["task.updated", "estimate.accepted"]
}
Projul replies with the endpoint's id (whe_...), status, and a signing secret (prjl_whsec_...) shown once, so copy it right away.
Choosing events and staying secure
Name events in event_types, or omit it for all 18, covering clients, projects and leads, estimates, tasks and messages; see Webhook Event Types: A Complete Breakdown. An unrecognized name is refused, listing the valid ones. Projul signs every message with your secret so you can confirm it came from Projul; see How do I secure my webhook endpoint?. Lost it? POST /v1/webhook_endpoints/{id}/rotate_secret; the old secret verifies for 24 hours while you switch.
Delivery status and retries
GET /v1/webhook_endpoints/{id} shows status, the last successful delivery, and the current failure run. Each attempt waits up to 10 seconds; failures retry up to 10 times over about a day, backing off from 30 seconds to 6 hours. After 20 straight failures over 24+ hours, Projul disables the endpoint, emails your account, and shows the reason and date under Settings, then "Projul AI Connect", in "Webhook endpoints." Fix it and use "Turn back on" there; no API call does this. Deliveries are kept 30 days: GET.../deliveries lists them, GET.../deliveries/{id} shows one, POST.../deliveries/{id}/replay resends it, for testing or recovering a miss. There is no test-message call; trigger your first delivery by updating a task or similar.
Change or remove an endpoint
An endpoint's address and events cannot be edited once created; delete it with DELETE /v1/webhook_endpoints/{id} and register a new one. Deleting stops delivery at once, closing anything in flight rather than sending it. History stays readable 30 days, but a delivery cannot be replayed once its endpoint is gone. List endpoints with GET /v1/webhook_endpoints.
Questions? Let's Chat.
support@projul.com
(844) 776-5853