MVMNT Event Notifications API
The Event Notifications API from MVMNT — 0 operation(s) for event notifications.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mvmnt-event-notifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: MVMNT Event Notifications API
version: 1.0.0
description: "The MVMNT API enables you to automate freight brokerage workflows by integrating\ndirectly with our Transportation Management System.\n\n## Authentication\n\nOAuth 2.0 client credentials flow. See [Authentication Guide](/getting-started/authentication)\nfor details.\n\n### Token Endpoint\n\n```\nPOST https://api.mvmnt.io/oauth2/token\n```\n\n#### Request\n\n**Headers:**\n```http\nContent-Type: application/x-www-form-urlencoded\n```\n\n**Body Parameters:**\n```\ngrant_type=client_credentials\nclient_id=YOUR_CLIENT_ID\nclient_secret=YOUR_CLIENT_SECRET\n```\n\n#### Example Request\n\n```bash\ncurl -X POST https://api.mvmnt.io/oauth2/token \\\n -H \"Content-Type: application/x-www-form-urlencoded\" \\\n -d \"grant_type=client_credentials\" \\\n -d \"client_id=YOUR_CLIENT_ID\" \\\n -d \"client_secret=YOUR_CLIENT_SECRET\"\n```\n\n#### Success Response\n\n**Status:** `200 OK`\n\n```json\n{\n \"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600\n}\n```\n\n**Response Fields:**\n- `access_token`: JWT Bearer token to use for API requests\n- `token_type`: Always `Bearer`\n- `expires_in`: Token lifetime in seconds (3600 = 1 hour)\n"
contact:
name: MVMNT Support
email: support@mvmnt.io
url: https://docs.mvmnt.io
license:
name: Proprietary
url: https://mvmnt.io/legal/terms
x-parsed-md-description:
result:
- $$mdtype: Node
errors: []
lines:
- 0
- 2
inline: false
attributes: {}
children:
- $$mdtype: Node
errors: []
lines:
- 0
- 2
inline: false
attributes: {}
children:
- $$mdtype: Node
errors: []
lines:
- 0
- 2
inline: true
attributes:
content: The MVMNT API enables you to automate freight brokerage workflows by integrating
children: []
type: text
annotations: []
slots: {}
- $$mdtype: Node
errors: []
lines:
- 0
- 2
inline: true
attributes: {}
children: []
type: softbreak
annotations: []
slots: {}
- $$mdtype: Node
errors: []
lines:
- 0
- 2
inline: true
attributes:
content: directly with our Transportation Management System.
children: []
type: text
annotations: []
slots: {}
type: inline
annotations: []
slots: {}
type: paragraph
annotations: []
slots: {}
- $$mdtype: Node
errors: []
lines:
- 3
- 4
inline: false
attributes:
level: 2
children:
- $$mdtype: Node
errors: []
lines:
- 3
- 4
inline: false
attributes: {}
children:
- $$mdtype: Node
errors: []
lines:
- 3
- 4
inline: true
attributes:
content: Authentication
children: []
type: text
annotations: []
slots: {}
type: inline
annotations: []
slots: {}
type: heading
annotations: []
slots: {}
- $$mdtype: Node
errors: []
lines:
- 5
- 6
inline: false
attributes: {}
children:
- $$mdtype: Node
errors: []
lines:
- 5
- 6
inline: false
attributes: {}
children:
- $$mdtype: Node
errors: []
lines:
- 5
- 6
inline: true
attributes:
content: 'OAuth 2.0 client credentials flow. See '
children: []
type: text
annotations: []
slots: {}
- $$mdtype: Node
errors: []
lines:
- 5
- 6
inline: true
attributes:
href: /getting-started/authentication
children:
- $$mdtype: Node
errors: []
lines:
- 5
- 6
inline: true
attributes:
content: Authentication Guide
children: []
type: text
annotations: []
slots: {}
type: link
annotations: []
slots: {}
redocly:::linkOriginal:href: /getting-started/authentication
- $$mdtype: Node
errors: []
lines:
- 5
- 6
inline: true
attributes:
content: ' for details.'
children: []
type: text
annotations: []
slots: {}
type: inline
annotations: []
slots: {}
type: paragraph
annotations: []
slots: {}
servers:
- url: https://api.mvmnt.io/v1
description: Production
security:
- BearerAuth: []
tags:
- name: Event Notifications
paths: {}
webhooks:
your-endpoint:
post:
summary: Webhook Event
description: 'All webhook events are delivered to your configured endpoint URL.
The `event` field in the payload determines which type of webhook was triggered.
Your endpoint should handle all event types or gracefully ignore unknown events.
**Event Types:**
- Entity changes: `CUSTOMER_*`, `COMPANY_*`, `CARRIER_*`, `CUSTOMER_CONTACT_*`
- Shipment events: `SHIPMENT_DELIVERED`, `SHIPMENT_BOOKED`, `SHIPMENT_DISPATCHED`, etc.
- Financial events: `CARRIER_INVOICE_CREATED`, `CUSTOMER_PAYMENT_CREATED`, etc.
**Security:** All webhook requests include an `x-api-key` header containing your webhook token configured in the MVMNT UI.
**Best Practices:**
- Return 200 OK quickly and process asynchronously
- Implement idempotency using event ID and timestamp
- Handle unknown event types gracefully for forward compatibility
'
operationId: webhookCallback
tags:
- Event Notifications
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WebhookDelivery'
examples:
customer_created:
summary: Customer created
value:
sentAt: '2025-01-15T14:30:05Z'
events:
- event: CUSTOMER_CREATED
timestamp: '2025-01-15T14:30:00Z'
data:
id: 660e8400-e29b-41d4-a716-446655440000
name: Acme Corporation
friendlyId: A123456
status: ACTIVE
serviceTier: PLATINUM
website: https://acme-manufacturing.com
phoneNumber: +1-555-123-4567
industry: MANUFACTURING
annualRevenue: OVER_100M
annualSpend: 10M_TO_50M
spendType: CONTRACT
naics: '336411'
ein: 12-3456789
duns: '123456789'
leadSource: Referral
dbaName: Acme Corp DBA
numberOfEmployees: 1000_TO_5000
externalId: EXT-12345
currency: USD
creditLimit: 50000
creditUsageWarning: 40000
freeCreditReq: 5000
defaultMode: FTL
defaultMargin: 0.15
minMargin: 0.1
maxMargin: 0.25
defaultInternalNotes: Contact via email only
defaultCarrierNotes: Call pickup contact before arrival
defaultExternalNotes: Please call 1 hour before delivery
defaultShowNotes: SPLIT
autoAcceptTender: false
group: null
paymentTerm:
id: 123e4567-e89b-12d3-a456-426614174000
name: Net 30
key: null
notes: Prefers email communication
deactivationReason: null
deactivationNotes: null
deactivationDate: null
closedAt: null
closedBy: null
closedNotes: null
corporateAddress:
addressLine1: 123 Corporate Blvd
addressLine2: Suite 100
city: Chicago
state: IL
postalCode: '60601'
country: USA
latitude: 41.8781
longitude: -87.6298
billingAddress:
addressLine1: 456 Billing Ave
addressLine2: null
city: Chicago
state: IL
postalCode: '60602'
country: USA
latitude: 41.8827
longitude: -87.6233
qboCustomerId: null
key: ERP-CUSTOMER-12345
createdAt: '2025-01-15T14:30:00Z'
updatedAt: '2025-01-15T14:30:00Z'
deletedAt: null
diff: null
customer_updated:
summary: Customer updated with diff
value:
sentAt: '2025-01-15T15:45:05Z'
events:
- event: CUSTOMER_UPDATED
timestamp: '2025-01-15T15:45:00Z'
data:
id: 660e8400-e29b-41d4-a716-446655440000
name: Acme Corporation
friendlyId: A123456
status: INACTIVE
serviceTier: GOLD
website: https://acme-manufacturing.com
phoneNumber: +1-555-999-8888
industry: MANUFACTURING
annualRevenue: OVER_100M
annualSpend: 50M_TO_100M
spendType: CONTRACT
naics: '336411'
ein: 12-3456789
duns: '123456789'
leadSource: Referral
dbaName: Acme Corp DBA
numberOfEmployees: 1000_TO_5000
externalId: EXT-12345
currency: USD
creditLimit: 75000
creditUsageWarning: 60000
freeCreditReq: 5000
defaultMode: FTL
defaultMargin: 0.15
minMargin: 0.1
maxMargin: 0.25
defaultInternalNotes: Contact via email only
defaultCarrierNotes: Call pickup contact before arrival
defaultExternalNotes: Please call 1 hour before delivery
defaultShowNotes: SPLIT
autoAcceptTender: false
group: null
paymentTerm:
id: 123e4567-e89b-12d3-a456-426614174000
name: Net 30
key: null
notes: Prefers email communication. Account under review.
deactivationReason: PAYMENT_ISSUES
deactivationNotes: Multiple late payments
deactivationDate: '2025-01-15T15:45:00Z'
closedAt: null
closedBy: null
closedNotes: null
corporateAddress:
addressLine1: 123 Corporate Blvd
addressLine2: Suite 100
city: Chicago
state: IL
postalCode: '60601'
country: USA
latitude: 41.8781
longitude: -87.6298
billingAddress:
addressLine1: 456 Billing Ave
addressLine2: null
city: Chicago
state: IL
postalCode: '60602'
country: USA
latitude: 41.8827
longitude: -87.6233
qboCustomerId: null
key: ERP-CUSTOMER-12345
createdAt: '2025-01-15T14:30:00Z'
updatedAt: '2025-01-15T15:45:00Z'
deletedAt: null
diff:
- type: UPDATE
key: status
value: INACTIVE
oldValue: ACTIVE
- type: UPDATE
key: serviceTier
value: GOLD
oldValue: PLATINUM
- type: UPDATE
key: phoneNumber
value: +1-555-999-8888
oldValue: +1-555-123-4567
- type: UPDATE
key: annualSpend
value: 50M_TO_100M
oldValue: 10M_TO_50M
- type: UPDATE
key: creditLimit
value: 75000
oldValue: 50000
- type: UPDATE
key: creditUsageWarning
value: 60000
oldValue: 40000
- type: UPDATE
key: notes
value: Prefers email communication. Account under review.
oldValue: Prefers email communication
- type: ADD
key: deactivationReason
value: PAYMENT_ISSUES
- type: ADD
key: deactivationNotes
value: Multiple late payments
- type: ADD
key: deactivationDate
value: '2025-01-15T15:45:00Z'
customer_deleted:
summary: Customer deleted
value:
sentAt: '2025-01-15T16:00:05Z'
events:
- event: CUSTOMER_DELETED
timestamp: '2025-01-15T16:00:00Z'
data:
id: 660e8400-e29b-41d4-a716-446655440000
diff: null
company_created:
summary: Company created
value:
sentAt: '2025-01-15T09:00:05Z'
events:
- event: COMPANY_CREATED
timestamp: '2025-01-15T09:00:00Z'
data:
id: 550e8400-e29b-41d4-a716-446655440000
name: Acme Logistics Inc
addressLine1: 123 Main St
addressLine2: Suite 400
city: Chicago
country: USA
fax: +1-555-0123
invoiceOnly: false
invoiceVerbiage: Please remit payment within 30 days
primaryContactName: John Smith
primaryContactEmail: john.smith@acmelogistics.com
primaryContactPhone: +1-555-0100
createdBy:
id: 550e8400-e29b-41d4-a716-446655440009
email: admin@example.com
name: Admin User
key: ERP-COMPANY-ACME-001
createdAt: '2025-01-15T09:00:00Z'
updatedAt: '2025-01-15T09:00:00Z'
deletedAt: null
diff: null
company_updated:
summary: Company updated with diff
value:
sentAt: '2025-01-15T11:00:05Z'
events:
- event: COMPANY_UPDATED
timestamp: '2025-01-15T11:00:00Z'
data:
id: 550e8400-e29b-41d4-a716-446655440000
name: Acme Logistics Corporation
addressLine1: 456 New Ave
addressLine2: Suite 200
city: New York
country: USA
fax: +1-555-0124
invoiceOnly: true
invoiceVerbiage: Payment due upon receipt
primaryContactName: Jane Doe
primaryContactEmail: jane.doe@acmelogistics.com
primaryContactPhone: +1-555-0101
createdBy:
id: 550e8400-e29b-41d4-a716-446655440009
email: admin@example.com
name: Admin User
key: ERP-COMPANY-ACME-001
createdAt: '2025-01-15T09:00:00Z'
updatedAt: '2025-01-15T11:00:00Z'
deletedAt: null
diff:
- type: UPDATE
key: name
value: Acme Logistics Corporation
oldValue: Acme Logistics Inc
- type: UPDATE
key: addressLine1
value: 456 New Ave
oldValue: 123 Main St
- type: UPDATE
key: addressLine2
value: Suite 200
oldValue: Suite 400
- type: UPDATE
key: city
value: New York
oldValue: Chicago
- type: UPDATE
key: fax
value: +1-555-0124
oldValue: +1-555-0123
- type: UPDATE
key: invoiceOnly
value: true
oldValue: false
- type: UPDATE
key: invoiceVerbiage
value: Payment due upon receipt
oldValue: Please remit payment within 30 days
- type: UPDATE
key: primaryContactName
value: Jane Doe
oldValue: John Smith
- type: UPDATE
key: primaryContactEmail
value: jane.doe@acmelogistics.com
oldValue: john.smith@acmelogistics.com
- type: UPDATE
key: primaryContactPhone
value: +1-555-0101
oldValue: +1-555-0100
company_deleted:
summary: Company deleted
value:
sentAt: '2025-01-15T12:00:05Z'
events:
- event: COMPANY_DELETED
timestamp: '2025-01-15T12:00:00Z'
data:
id: 550e8400-e29b-41d4-a716-446655440000
diff: null
customer_contact_created:
summary: Customer contact created
value:
sentAt: '2025-01-15T13:00:05Z'
events:
- event: CUSTOMER_CONTACT_CREATED
timestamp: '2025-01-15T13:00:00Z'
data:
id: 990e8400-e29b-41d4-a716-446655440002
customer:
id: 660e8400-e29b-41d4-a716-446655440000
name: Acme Corporation
friendlyId: A123456
name: Sarah Johnson
contactInfo:
name: Sarah Johnson
email: sarah.johnson@example.com
phone: +1-555-0123
title: Logistics Manager
phoneExtension: '1234'
isPrimary: true
contactTypes:
- BILLING
- ACCOUNT_MANAGER
notifications:
- SHIPMENT_PICKED_UP
- SHIPMENT_DELIVERED
invitedUser: null
deletedBy: null
key: ERP-CONTACT-SARAH-001
createdAt: '2025-01-15T13:00:00Z'
deletedAt: null
diff: null
customer_contact_updated:
summary: Customer contact updated with diff
value:
sentAt: '2025-01-15T13:30:05Z'
events:
- event: CUSTOMER_CONTACT_UPDATED
timestamp: '2025-01-15T13:30:00Z'
data:
id: 990e8400-e29b-41d4-a716-446655440002
customer:
id: 660e8400-e29b-41d4-a716-446655440000
name: Acme Corporation
friendlyId: A123456
name: Sarah Johnson-Smith
contactInfo:
name: Sarah Johnson-Smith
email: sarah.js@example.com
phone: +1-555-9999
title: Senior Logistics Manager
phoneExtension: '5678'
isPrimary: false
contactTypes:
- BILLING
- PROCUREMENT
- RATES_PRICING
notifications:
- SHIPMENT_IN_TRANSIT
- SHIPMENT_DELIVERED
- SHIPMENT_TENDER_REJECTED
invitedUser:
id: 880e8400-e29b-41d4-a716-446655440003
email: sarah.js@example.com
name: Sarah Johnson-Smith
deletedBy: null
key: ERP-CONTACT-SARAH-001
createdAt: '2025-01-15T13:00:00Z'
deletedAt: null
diff:
- type: UPDATE
key: name
value: Sarah Johnson-Smith
oldValue: Sarah Johnson
- type: UPDATE
key: contactInfo
changes:
- type: UPDATE
key: name
value: Sarah Johnson-Smith
oldValue: Sarah Johnson
- type: UPDATE
key: email
value: sarah.js@example.com
oldValue: sarah.johnson@example.com
- type: UPDATE
key: phone
value: +1-555-9999
oldValue: +1-555-0123
- type: UPDATE
key: title
value: Senior Logistics Manager
oldValue: Logistics Manager
- type: UPDATE
key: phoneExtension
value: '5678'
oldValue: '1234'
- type: UPDATE
key: isPrimary
value: false
oldValue: true
- type: UPDATE
key: contactTypes
changes:
- type: REMOVE
key: '1'
oldValue: ACCOUNT_MANAGER
- type: ADD
key: '1'
value: PROCUREMENT
- type: ADD
key: '2'
value: RATES_PRICING
- type: UPDATE
key: notifications
changes:
- type: UPDATE
key: '0'
value: SHIPMENT_IN_TRANSIT
oldValue: SHIPMENT_PICKED_UP
- type: ADD
key: '2'
value: SHIPMENT_TENDER_REJECTED
- type: ADD
key: invitedUser
value:
id: 880e8400-e29b-41d4-a716-446655440003
email: sarah.js@example.com
name: Sarah Johnson-Smith
customer_contact_deleted:
summary: Customer contact deleted
value:
sentAt: '2025-01-15T14:00:05Z'
events:
- event: CUSTOMER_CONTACT_DELETED
timestamp: '2025-01-15T14:00:00Z'
data:
id: 990e8400-e29b-41d4-a716-446655440002
diff: null
carrier_created:
summary: Carrier created (truckload)
value:
sentAt: '2025-01-15T08:00:05Z'
events:
- event: CARRIER_CREATED
timestamp: '2025-01-15T08:00:00Z'
data:
id: 770e8400-e29b-41d4-a716-446655440000
friendlyId: C123456
type: TRUCKLOAD
name: Fast Transport LLC
dbaName: Fast Logistics
key: ERP-CARRIER-FAST-001
email: dispatch@fasttransport.com
phone: +1-555-0200
website: https://fasttransport.com
status: ACTIVE
statusReason: null
notes: Preferred carrier for midwest routes
corporateAddress:
addressLine1: 789 Transport Way
addressLine2: null
city: Dallas
state: TX
postalCode: '75201'
country: USA
latitude: 32.7767
longitude: -96.797
billingAddress:
addressLine1: PO Box 12345
addressLine2: null
city: Dallas
state: TX
postalCode: '75202'
country: USA
latitude: null
longitude: null
mcNumber: MC-123456
dotNumber: '1234567'
scac: FAST
einNumber: 12-3456789
ffNumber: null
mxNumber: null
rfcNumber: null
iataCode: null
equipments:
- VAN
- REEFER
- FLATBED
isHazmat: false
tsaApproved: true
trucks: 50
trailers: 100
drivers: 75
powerUnits: 50
currency: USD
paymentTerm:
id: 550e8400-e29b-41d4-a716-446655440002
name: Net 30
key: null
isFactoringPreferred: false
goldenCarrierId: null
insuranceCompany: State Farm Insurance
insuranceAgent: John Smith
insuranceAgentPhone: +1-555-123-4567
insuranceAuthorityDate: '2025-01-01T00:00:00Z'
insuranceExpirationDate: '2025-12-31T23:59:59Z'
insuranceAutoLiabilityLimit: 1000000
insuranceCargoLiabilityLimit: 100000
insuranceGeneralLiabilityLimit: 1000000
rating: SATISFACTORY
ratingDate: '2025-01-15'
reviewType: COMPLIANCE_REVIEW
reviewDate: '2025-01-15'
operatingAbility: AUTHORIZED
inFmcsa: true
usDriverInspections: 100
usDriverInspectionsOos: 5
usDriverInspectionsOosPct: 5
usVehicleInspections: 150
usVehicleInspectionsOos: 8
usVehicleInspectionsOosPct: 5.33
createdAt: '2025-01-15T08:00:00Z'
updatedAt: '2025-01-15T08:00:00Z'
deletedAt: null
diff: null
carrier_updated:
summary: Carrier updated with diff
value:
sentAt: '2025-01-15T10:30:05Z'
events:
- event: CARRIER_UPDATED
timestamp: '2025-01-15T10:30:00Z'
data:
id: 770e8400-e29b-41d4-a716-446655440000
friendlyId: C123456
type: TRUCKLOAD
name: Fast Transport LLC
dbaName: Fast Logistics Express
key: ERP-CARRIER-FAST-001
email: newdispatch@fasttransport.com
phone: +1-555-0201
website: https://fasttransport.com
status: INACTIVE
statusReason: Contract expired
notes: Contract renewal pending. Good safety record.
corporateAddress:
addressLine1: 789 Transport Way
addressLine2: Building B
city: Dallas
state: TX
postalCode: '75201'
country: USA
latitude: 32.7767
longitude: -96.797
billingAddress:
addressLine1: PO Box 12345
addressLine2: null
city: Dallas
state: TX
postalCode: '75202'
country: USA
latitude: null
longitude: null
mcNumber: MC-123456
dotNumber: '1234567'
scac: FAST
einNumber: 12-3456789
ffNumber: null
mxNumber: null
rfcNumber: null
iataCode: null
equipments:
- VAN
- REEFER
- FLATBED
- POWER_ONLY
isHazmat: true
tsaApproved: true
trucks: 60
trailers: 120
drivers: 85
powerUnits: 60
currency: USD
paymentTerm:
id: 550e8400-e29b-41d4-a716-446655440002
name: Net 30
key: null
isFactoringPreferred: false
goldenCarrierId: null
insuranceCompany: State Farm Insurance
insuranceAgent: Jane Doe
insuranceAgentPhone: +1-555-123-4568
insuranceAuthorityDate: '2025-01-01T00:00:00Z'
insuranceExpirationDate: '2026-12-31T23:59:59Z'
insuranceAutoLiabilityLimit: 2000000
insuranceCargoLiabilityLimit: 250000
insuranceGeneralLiabilityLimit: 2000000
rating: SATISFACTORY
ratingDate: '2025-01-15'
reviewType: COMPLIANCE_REVIEW
reviewDate: '2025-01-15'
operatingAbility: AUTHORIZED
# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mvmnt/refs/heads/main/openapi/mvmnt-event-notifications-api-openapi.yml