ROroutable
Companies

Create a Company

Changed on

Business or Personal?

When creating a company, take note that there are two different types of companies: business and personal.

  • You would create a company as business when they are acting as a sole proprietorship, LLC, or corporation.
  • You would create a company as personal when they are acting as a contractor or a freelancer.

Also, take note that the parameters available to configure the company are slightly different between the two types of companies. We've documented these differences in the request schema.

What's in a name?

When creating a company, we allow you to set different names based on the type of company.

⚠

If the business_name for your company is incorrect, it can cause issues for payments.

  • The business_name is the legal name of the Company entity. For Companies of type business, you can set it in the Create Company payload directly. For personal type Companies, it will be automatically set by concatenating the Contact's first_name and last_name.
  • The display_name is what will show in the Routable Dashboard. It defaults to the value of business_name unless explicitly provided.
  • The ledger_name is what will be recorded for this Company in your linked accounting software. It defaults to the value of business_name unless explicitly provided.

When working with many personal companies, it's common to run into naming collisions. We recommend including some sort of unique ID in the name such as Jane Doe [bHvRzbRA]. Your finance team might have preferences here - Check with them 💪.

Contacts

Companies have Contacts that are the recipient of messages pertaining to the Company.

These resources are created when you create a Company.

A Company can have Contacts added, archived and updated at a later time via the Contacts module.

post/v1/companies

Request

Request body

OR

Response

Created

object'Company' required

The object’s type (Company).

idstring uuid required

The Company ID.

business_namestring required

The Company's business name for banking and tax purposes.

collect_tax_formboolean

Defaults to true if you use tax collection in your Routable workspace, false otherwise.

country_code'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CV' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IQ' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MX' | 'MW' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RW' | 'SA' | 'SB' | 'SC' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'ST' | 'SV' | 'SX' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VI' | 'VN' | 'VU' | 'XK' | 'WF' | 'WS' | 'XX' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW'

Country code in ISO 3166-1 Alpha-2 format.

created_atstring date-time required

The date the Company was created.

display_namestring required

The Company's name for display in the Routable Dashboard.

external_idstring nullable required

A unique ID from your system to identify this Company.

is_archivedboolean

Whether this Company has been archived.

is_customerboolean required

Whether this Company is a customer.

is_vendorboolean required

Whether this Company is a vendor.

risk_summary'cant_validate' | 'dismissed' | 'not_evaluated' | 'outdated' | 'passed' | 'queued' | 'review_required'

Compliance Check status for a Company:

  • cant_validate: An error happened and the verification couldn't be finished.
  • dismissed: There were issues found (review_required), but they were dismissed by a team member.
  • not_evaluated: Not enrolled for risk monitoring.
  • outdated: When legal data changes outside of the tax flows.
  • passed: Risk checks are all clear.
  • queued: Company was queued for enrollment in risk monitoring.
  • review_required: Identified issues for the entity - Watchlist hits or a TIN mismatch.
status'accepted' | 'added' | 'invited' required

The status of the Company's onboarding.

  • When set to added, this indicates that you have added the Company to Routable. This will be the starting status.
  • When set to invited, this indicates that you have also sent this Company an invitation to submit their business and banking information with Routable.
  • When set to accepted, this indicates that the Company has accepted your invitation and submitted their business and banking information with Routable.
tax_form_status'archived' | 'completed' | 'expired' | 'none' required

Current status of company's tax form.

tax_form_type'w9' | 'w8ben' | 'w8ben_e' nullable

Type of the tax form that the vendor can submit.

type'business' | 'personal' required

The type of Company.

Changes

  • 9d71f3ec4b5cRevision changes
    • warning

      changed the pattern of the request property /////////// from ^\+?[1-9]\d{1,14}$ to ^\+[1-9]\d{1,14}$

    • warning

      changed the pattern of the request property /////////// from ^\+?[1-9]\d{1,14}$ to ^\+[1-9]\d{1,14}$

    • info

      the //////// response's property pattern was changed from ^\+?[1-9]\d{1,14}$ to ^\+[1-9]\d{1,14}$ for the status