MVMNT Webhooks

asyncapi: 3.0.0
info:
  title: MVMNT Webhooks
  version: 1.0.0
  description: AsyncAPI description of MVMNT's outbound webhook surface, generated by API Evangelist from
    the real webhook definition and event enum in the MVMNT OpenAPI 3.1 description. MVMNT POSTs a WebhookDelivery
    envelope to a subscriber-configured endpoint whenever freight-brokerage entities change or shipment/financial
    events occur.
defaultContentType: application/json
servers:
  subscriber:
    host: your-endpoint.example.com
    protocol: https
    description: Subscriber-hosted HTTPS endpoint configured in the MVMNT UI.
channels:
  webhookDelivery:
    address: /
    title: Webhook delivery endpoint
    description: All MVMNT webhook events are delivered here as a WebhookDelivery payload. The `event`
      field selects the event type. Requests carry an x-api-key header with the webhook token.
    messages:
      webhookDelivery:
        $ref: '#/components/messages/WebhookDelivery'
operations:
  receiveWebhook:
    action: receive
    channel:
      $ref: '#/channels/webhookDelivery'
    summary: Receive an MVMNT webhook delivery
    messages:
    - $ref: '#/channels/webhookDelivery/messages/webhookDelivery'
components:
  messages:
    WebhookDelivery:
      name: WebhookDelivery
      title: Webhook delivery
      contentType: application/json
      headers:
        type: object
        properties:
          x-api-key:
            type: string
            description: Webhook token configured in the MVMNT UI.
      payload:
        type: object
        required:
        - sentAt
        - events
        properties:
          sentAt:
            type: string
            format: date-time
          events:
            type: array
            minItems: 1
            items:
              type: object
              required:
              - event
              - timestamp
              - data
              properties:
                event:
                  type: string
                  enum:
                  - CARRIER_ACTIVATED
                  - CARRIER_CONTACT_CREATED
                  - CARRIER_CONTACT_UPDATED
                  - CARRIER_CONTACT_DELETED
                  - CARRIER_CREATED
                  - CARRIER_DEACTIVATED
                  - CARRIER_DELETED
                  - CARRIER_FACTOR_CREATED
                  - CARRIER_FACTOR_UPDATED
                  - CARRIER_FACTOR_DELETED
                  - CARRIER_INVOICE_CREATED
                  - CARRIER_PAYMENT_CREATED
                  - CARRIER_PAYMENT_METHOD_CREATED
                  - CARRIER_PAYMENT_METHOD_UPDATED
                  - CARRIER_PAYMENT_METHOD_DELETED
                  - CARRIER_UPDATED
                  - COMMISSION_APPROVED
                  - COMMISSION_CREATED
                  - COMPANY_CREATED
                  - COMPANY_UPDATED
                  - COMPANY_DELETED
                  - CUSTOMER_CREATED
                  - CUSTOMER_UPDATED
                  - CUSTOMER_DELETED
                  - CUSTOMER_CONTACT_CREATED
                  - CUSTOMER_CONTACT_UPDATED
                  - CUSTOMER_CONTACT_DELETED
                  - CUSTOMER_INVOICE_CREATED
                  - CUSTOMER_PAYMENT_CREATED
                  - DOCUMENT_UPLOADED
                  - QUOTE_CREATED
                  - QUOTE_LOST
                  - QUOTE_QUOTED
                  - QUOTE_REQUESTED
                  - QUOTE_WON
                  - SHIPMENT_BOOKED
                  - SHIPMENT_CANCELED
                  - SHIPMENT_CHECK_CALL
                  - SHIPMENT_CREATED
                  - SHIPMENT_DELETED
                  - SHIPMENT_DELIVERED
                  - SHIPMENT_DISPATCHED
                  - SHIPMENT_DRAFT
                  - SHIPMENT_IN_TRANSIT
                  - SHIPMENT_LOADING
                  - SHIPMENT_NEXT_CHECK_CALL_DUE
                  - SHIPMENT_NEXT_CHECK_CALL_OVERDUE
                  - SHIPMENT_OPEN
                  - SHIPMENT_PICK_UP_NEAR_NOT_BOOKED
                  - SHIPMENT_PICK_UP_NEAR_NOT_DISPATCHED
                  - SHIPMENT_RATE_CON_EXPIRED
                  - SHIPMENT_RATE_CON_NOT_SIGNED
                  - SHIPMENT_RATE_CON_SIGNED
                  - SHIPMENT_TENDER_PENDING
                  - SHIPMENT_TENDER_REJECTED
                  - SHIPMENT_UNLOADING
                  - VENDOR_CREATED
                  - VENDOR_UPDATED
                  - VENDOR_DELETED
                  - VENDOR_CONTACT_CREATED
                  - VENDOR_CONTACT_UPDATED
                  - VENDOR_CONTACT_DELETED
                  - VENDOR_INVOICE_CREATED
                  - VENDOR_PAYMENT_CREATED
                  - VENDOR_PAYMENT_METHOD_CREATED
                  - VENDOR_PAYMENT_METHOD_UPDATED
                  - VENDOR_PAYMENT_METHOD_DELETED
                  - LOCATION_CREATED
                  - LOCATION_UPDATED
                  - LOCATION_DELETED
                  - LOCATION_CONTACT_CREATED
                  - LOCATION_CONTACT_UPDATED
                  - LOCATION_CONTACT_DELETED
                timestamp:
                  type: string
                  format: date-time
                data:
                  type: object
                  description: Entity snapshot for the event.
x-generated:
  by: API Evangelist enrichment pipeline
  method: generated
  source: openapi/mvmnt-openapi-original.yml
  date: '2026-07-20'

# --- API Evangelist provenance -------------------------------------------
x-superseded-by:
  reason: >-
    Provider publishes this event surface themselves in as-published OpenAPI; this document was authored by API Evangelist before that source was harvested.
  published_spec: all/mvmnt/openapi/_original/mvmnt-openapi-original.yml
  published_event_object: webhooks
  published_events: 1
  status: superseded
  reviewed: '2026-07-31'