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

Companies

Create a new company

Changed on Oct 7, 2026

Create a new company within an organization

post/companies

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/companies
Auth: HTTP bearer

Request body

namestring required

Company legal name

addressLine1string

Primary street address

addressLine2string

Secondary address line (suite, floor, etc.)

citystring

City name

countrystring

Country code or name

faxstring

Fax number

invoiceOnlyboolean

Whether this company is used only for invoicing purposes

invoiceVerbiagestring

Custom text to include on invoices for this company

primaryContactNamestring

Name of primary contact person

primaryContactEmailstring email

Email address of primary contact

primaryContactPhonestring

Phone number of primary contact

keystring

Client-defined reference identifier

Example request

{
  "name": "Acme Logistics Inc",
  "addressLine1": "123 Main St",
  "addressLine2": "Suite 400",
  "city": "Chicago",
  "country": "USA",
  "fax": "+1-555-0123",
  "invoiceVerbiage": "Please remit payment within 30 days",
  "primaryContactName": "John Smith",
  "primaryContactEmail": "john.smith@acmelogistics.com",
  "primaryContactPhone": "+1-555-0100",
  "key": "ERP-COMPANY-ACME-001"
}

Response

Company created successfully

object'COMPANY'

Object type identifier

idstring uuid required

Unique company identifier

namestring required

Company legal name

addressLine1string nullable

Primary street address

addressLine2string nullable

Secondary address line (suite, floor, etc.)

citystring nullable

City name

countrystring nullable

Country code or name

faxstring nullable

Fax number

invoiceOnlyboolean nullable

Whether this company is used only for invoicing purposes

invoiceVerbiagestring nullable

Custom text to include on invoices for this company

primaryContactNamestring nullable

Name of primary contact person

primaryContactEmailstring email nullable

Email address of primary contact

primaryContactPhonestring nullable

Phone number of primary contact

keystring nullable

Client-defined reference identifier

createdAtstring date-time required

When the company was created

updatedAtstring date-time required

When the company was last updated

deletedAtstring date-time nullable

When the company was soft deleted (null if active)

Example response

{
  "object": "COMPANY",
  "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",
  "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-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"
  },
  "key": "ERP-COMPANY-ACME-001",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30: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

Operation history