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.

Allowed values:

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"
>	]
>	}'

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