---
title: "Create webhook subscription"
method: POST
path: "/v2/webhook-subscriptions"
tags: ["Webhook Event Subscriptions"]
---

# Create webhook subscription

`POST /v2/webhook-subscriptions`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v2/webhook-subscriptions`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v2/webhook-subscriptions/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a subscription from a public webhook endpoint to one public event type. `isActive` is optional and defaults to `true`. The endpoint must exist and must be a public webhook endpoint for the authenticated brokerage. Duplicate subscriptions for the same `webhookEndpointId` and `eventType` are rejected with `409`. After creating the subscription, send a test delivery for the returned subscription `id`. Subscriptions created through these public APIs deliver version 2 webhook event shapes for the selected event type.

Access to webhook management is gated by brokerage. Talk to Augment to enable access before relying on this endpoint.

## Request body

- CreateWebhookSubscriptionRequest: Request body for creating a public webhook subscription.
  - `webhookEndpointId` string, required: Webhook endpoint ID that should receive this event type
  - `eventType` 'TRACKING_UPDATE' | 'STOP_UPDATE' | 'LOAD_CARRIER_UPDATE' | 'SEND_TMS_COMMENT' | 'SCHEDULED_CARRIER_OUTREACH' | 'UPLOAD_FILES' | 'PUSH_BID_TO_TMS' | 'PUSH_LOAD_DRAFT' | 'CARRIER_ISSUE_UPDATED', required: Public event type for webhook subscription creation. Call `GET /v2/webhook-event-types` for the current source of truth.
  - `isActive` boolean: Whether this subscription should be active. Defaults to `true`.

## Response `201`

Webhook subscription created successfully

- WebhookSubscription: Public webhook subscription connecting one webhook endpoint to one event type.
  - `id` string, required: Webhook subscription ID
  - `webhookEndpointId` string, required: Webhook endpoint ID that receives this event type
  - `eventType` 'TRACKING_UPDATE' | 'STOP_UPDATE' | 'LOAD_CARRIER_UPDATE' | 'SEND_TMS_COMMENT' | 'SCHEDULED_CARRIER_OUTREACH' | 'UPLOAD_FILES' | 'PUSH_BID_TO_TMS' | 'PUSH_LOAD_DRAFT' | 'CARRIER_ISSUE_UPDATED', required: Public event type for webhook subscription creation. Call `GET /v2/webhook-event-types` for the current source of truth.
  - `isActive` boolean, required: Whether this subscription is active

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Webhook management access is not enabled for this brokerage
- `409`: Webhook endpoint already has a subscription for this event type

---

[API](https://skmtc.dev/goaugment/apis/augment-api.md) - [All operations](https://skmtc.dev/goaugment/apis/augment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/augment-api/revisions/b61097634d79?raw)