COMPANY

Creates a new company.

POST/api/v2/companies

Authentication

Choose one supported method for this request.

OAuth 2.0 client credentialsAPI key

Request body

application/jsonrequired

The company data to create.

companyNamestring
legalNamestringnullable
accountNostring
statusstring
address1string
address2string
address3string
citystring
statestring
zipstring
countystring
countrystring
phonestring
faxstring
webstring
recordTypeIdinteger · int32
branchIdinteger · int32
parentIdinteger · int32
sourceIdinteger · int32
assignedRepPrimaryIdinteger · int32
assignedRepSecondaryIdsinteger[]

Responses

Company created successfully.

Standard response envelopeisSuccessmessageerrorsdata

Read the result from data. When isSuccess is false, errors lists what went wrong. Handling errors

companyIdinteger · int32
parentIdinteger · int32
recordTypeIdinteger · int32
branchIdinteger · int32
companyNamestring
legalNamestring
accountNostring
address1string
address2string
address3string
citystring
statestring
zipstring
countystring
countrystring
mailingbooleannullable
latitudenumber · double
longitudenumber · double
phonestring
faxstring
webstring
linkedboolean
sourceIdinteger · int32
statusstring
enteredstring · date-time
lastModifiedstring · date-time
completeboolean
parentNamestring
parentAccountNostring
assignedRecordTypestring
assignedBranchstring
assignedNationalAccountsstring
assignedNationalAccountIdsstring
assignedSourcestring
buyIDstring

REQUEST EXAMPLE

curl --request POST \
  'https://apiv2.crmseries.com/api/v2/companies' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "companyName": "Acme Equipment Co.",
    "legalName": "Acme Equipment Co.",
    "accountNo": "string",
    "status": "string",
    "address1": "100 Main St",
    "address2": "100 Main St",
    "address3": "100 Main St",
    "city": "Chicago",
    "state": "IL",
    "zip": "60601",
    "county": "Cook",
    "country": "US",
    "phone": "555-0100",
    "fax": "555-0100",
    "web": "https://example.com",
    "recordTypeId": 1024,
    "branchId": 1024,
    "parentId": 1024,
    "sourceId": 1024,
    "assignedCategories": [
      {
        "categoryId": 1024,
        "categoryName": "string"
      }
    ],
    "assignedRanks": [
      {
        "role": "string",
        "rank": "string",
        "roleID": 1024,
        "rankID": 1024,
        "editable": true,
        "availableRanks": [
          {
            "value": "string",
            "display": "string",
            "group": "string",
            "scope": "string",
            "dateRange": true
          }
        ]
      }
    ],
    "assignedRepPrimaryId": 1024,
    "assignedRepSecondaryIds": [
      1024
    ],
    "udfs": [
      {
        "fieldName": "string",
        "fieldValue": "string",
        "recordType": "string"
      }
    ]
  }'

Replace the uppercase placeholders and sample values with your integration values.

RESPONSE · 200

{
  "isSuccess": true,
  "message": "",
  "data": {
    "companyId": 1024,
    "parentId": 1024,
    "recordTypeId": 1024,
    "branchId": 1024,
    "companyName": "Acme Equipment Co.",
    "legalName": "Acme Equipment Co.",
    "accountNo": "string",
    "address1": "100 Main St",
    "address2": "100 Main St",
    "address3": "100 Main St",
    "city": "Chicago",
    "state": "IL",
    "zip": "60601",
    "county": "Cook",
    "country": "US",
    "mailing": true,
    "latitude": 41.8781,
    "longitude": -87.6298,
    "phone": "555-0100",
    "fax": "555-0100",
    "web": "https://example.com",
    "linked": true,
    "sourceId": 1024,
    "status": "string",
    "entered": "2026-01-15T14:30:00Z",
    "lastModified": "2026-01-15T14:30:00Z",
    "complete": true,
    "parentName": "string",
    "parentAccountNo": "string",
    "assignedRecordType": "string",
    "assignedBranch": "string",
    "assignedNationalAccounts": "string",
    "assignedNationalAccountIds": "string",
    "assignedSource": "string",
    "assignedRanks": [
      {
        "role": "string",
        "rank": "string",
        "roleID": 1024,
        "rankID": 1024,
        "editable": true,
        "availableRanks": [
          {
            "value": "string",
            "display": "string",
            "group": "string",
            "scope": "string",
            "dateRange": true
          }
        ]
      }
    ],
    "buyID": "string",
    "assignedCredits": [
      {
        "creditAmount": 125000.5,
        "creditType": "string",
        "comment": "string"
      }
    ],
    "assignedCategories": [
      {
        "categoryId": 1024,
        "categoryName": "string"
      }
    ],
    "recordAccessRights": {
      "exists": true,
      "view": true,
      "edit": true,
      "delete": true,
      "addNote": true
    }
  },
  "errors": []
}