Register a webhook endpoint

Creates a new webhook subscription. Returns the full webhook object including the signing secret (shown only on creation).

Authentication

AuthorizationBearer

Autolane Platform API key. Org-scoped with granular permissions. Deliveries endpoints additionally require an x-retailer-id header containing the site UUID from the Autolane Portal; webhooks endpoints do not.

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"

HTTPS URL where webhook events will be delivered.

eventslist of enumsRequired

Events to subscribe to.

Response

Webhook created. The signing secret is returned in full.

successboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

500

Internal Server Error

$	curl -X POST https://api.goautolane.com/dd/v1/webhooks \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"url": "https://retailer.com/webhooks/autolane",
>	"events": [
>	"pickup_status.changed",
>	"tracking_link.created",
>	"pickup.vehicle_location.changed"
>	]
>	}'

1	{
2	"success": true,
3	"data": {
4	"id": 1,
5	"url": "https://retailer.com/webhooks/autolane",
6	"events": [
7	"pickup_status.changed"
8	],
9	"display_name": "Production hook",
10	"secret": "alwh_****...",
11	"is_active": true,
12	"consecutive_failures": 0,
13	"last_delivered_at": "2026-04-10T12:00:00Z",
14	"created_at": "2026-04-10T10:00:00Z",
15	"updated_at": "2026-04-10T10:00:00Z"
16	}
17	}