Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Vendor Contacts

Create a new vendor contact

Changed on Oct 7, 2026

Create a new contact for a vendor.

Contacts represent individuals at the vendor who can be reached for various purposes.

post/vendor-contacts

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/vendor-contacts
Auth: HTTP bearer

Request body

vendorIdstring uuid required

Vendor this contact belongs to

namestring required

Contact person's name (required)

emailstring email

Contact email address

phonestring

Contact phone number

rolestring

Contact role or title (deprecated - use roles array)

rolesVendorContactRole[]

Types/roles this contact serves

Example request

{
  "vendorId": "550e8400-e29b-41d4-a716-446655440001",
  "name": "John Smith",
  "email": "john.smith@abcwarehouse.com",
  "phone": "+1-555-123-4567",
  "role": "Billing Manager",
  "roles": [
    "BILLING",
    "AGENT"
  ]
}

Response

Vendor contact created successfully

idstring uuid required

Unique identifier. Addresses this contact on GET/PATCH/DELETE /vendor-contacts/{id} — those routes existed while the create response omitted the id they take.

namestring nullable

Contact name

object'VENDOR_CONTACT'

Object type identifier

emailstring email nullable

Contact email address

phonestring nullable

Contact phone number

rolestring nullable

Contact role or title (deprecated - use roles array)

rolesVendorContactRole[] nullable

Types/roles this contact serves

createdAtstring date-time required

When the contact was created

deletedAtstring date-time nullable

When the contact was soft deleted (null if active)

Example response

{
  "name": "Dana Reyes",
  "object": "VENDOR_CONTACT",
  "vendor": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345"
  },
  "email": "john.smith@abcwarehouse.com",
  "phone": "+1-555-123-4567",
  "role": "Billing Manager",
  "roles": [
    "BILLING",
    "AGENT"
  ],
  "deletedBy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345",
    "email": "john.doe@example.com",
    "name": "John Doe",
    "phone": "+1-555-123-4567",
    "phoneExt": "123",
    "status": "ACTIVE",
    "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "createdAt": "2025-01-15T10:00:00Z"
}

Changes

Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Sep 21, 202684e136f9f294 Revision changes
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status

Operation history (3 revisions)