Skip to main content

Create ConnectWise Company (API)

The Create ConnectWise Company action creates a company in ConnectWise Manage. This is a single API call action that uses the exact company values you provide.

Single API Call Action

This action creates one company record. You must provide the company details directly. Learn more about the difference between workflow actions and single API call actions.

When to Use This Action​

Use this action when:

  • You already know you need a new company
  • You collected company details from a form or another system
  • You need the new company ID for later contact or ticket actions

Configuration​

Connection​

FieldDescription
ConnectWise ConnectionSelect the ConnectWise connection to use.

Company Information​

FieldDescription
Company IdentifierShort unique company identifier. Supports text expressions.
Company NameCompany display name. Supports text expressions.
StatusCompany status. Select from ConnectWise or unlock the field for a dynamic ID.
TypeOptional company types. Select one or more values from the dropdown, or unlock the field for dynamic IDs.
TerritoryOptional company territory. Select from ConnectWise or unlock the field for a dynamic ID.
MarketOptional company market. Select from ConnectWise or unlock the field for a dynamic ID.
Parent CompanyOptional existing parent company. Select from ConnectWise or unlock the field for a dynamic ID.

Assign Multiple Types and Optional Relationships​

Open the Type dropdown and select the types you want, for example Customer and Managed Services. You can search for another type without removing earlier selections. Each selected type appears as a chip. Use a chip's remove control to remove that type. The action sends all selected types with the company details in the same create request.

To use a variable instead of a fixed selection, unlock the relevant field and enter a text expression, such as {{custom.territory.id}} for Territory. For Type, unlock the field, then unlock an existing value to edit it or click Add expression to add another type ID. Enter each type ID as a separate expression. Expressions must return a positive numeric ID, not a name. If you only have a name, select the matching item in the field or find its ID before this action.

Clear Type to omit company types. Leave Territory, Market, or Parent Company blank to omit that value. The action does not choose defaults for these fields.

Address​

FieldDescription
Address Line 1Primary street address. Supports text expressions.
Address Line 2Secondary street address. Supports text expressions.
CityCompany city. Supports text expressions.
StateCompany state or province. Supports text expressions.
Zip / Postal CodeCompany zip or postal code. Supports text expressions.
CountryCompany country. Select from ConnectWise or unlock the field for a dynamic ID.

Details​

FieldDescription
Phone NumberMain company phone number. Supports text expressions.
WebsiteCompany website. Supports text expressions.
Account NumberOptional account number. Supports text expressions.
Annual RevenueOptional annual revenue value.
Number of EmployeesOptional number of employees.

Error Handling​

FieldDescription
Error HandlingAction to take if company creation fails.

Returned Variables​

When you configure Store the results in Variable, the created company becomes available:

PropertyTypeDescription
idnumberThe created company ID
identifierstringCompany identifier
namestringCompany name
statusobjectCompany status (id, name)
typesarray of objectsCompany types, each with id and name, when ConnectWise returns them
territoryobjectTerritory reference, when ConnectWise returns it
marketobjectMarket reference, when ConnectWise returns it
parentCompanyobjectParent company reference, when ConnectWise returns it
addressLine1stringPrimary street address
citystringCity
statestringState or province
zipstringZip or postal code
phoneNumberstringMain phone number
websitestringWebsite

Example usage: {{custom.company.id}}

Example Use Cases​

Create a Company From Form Data​

SettingValue
Company Identifier{{form.company_code}}
Company Name{{form.company_name}}
Phone Number{{form.phone}}
Website{{form.website}}

Classify a New Healthcare Customer​

Select values that exist in your ConnectWise account:

SettingValue
Company IdentifierNORTHSTAR-CLINIC
Company NameNorthstar Clinic
TypeCustomer and Managed Services
TerritoryNortheast
MarketHealthcare
Parent CompanyNorthstar Group, if this company belongs to that parent

This configuration creates one company with both types. Leave Parent Company blank if you do not want to link it to an existing parent company.

Create a Contact Afterward​

After this action stores the result in company, use Create ConnectWise Contact and set Company to {{custom.company.id}}.