--- title: "Create a Company" method: POST path: "/v1/companies" tags: ["Companies"] --- # Create a Company `POST /v1/companies` ### 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. | | `name` | `business_name` | |------------|-----------------------|-------------------------------------------------| | `business` | Set from `business_name` | โœ… | | `personal` | โœ… | Set from contact's `first_name`
and `last_name` | 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 APIs. ## Request body - union - CompaniesNewCompanyBusiness - `acting_team_member` string, uuid, required โ€” The ID of a Team Member performing this action. This will be displayed in the Routable Dashboard. - `business_name` string, required โ€” The Company's business name for banking and tax purposes. The Company's `display_name`, if not explicitly set, will be automatically set based on the `business_name`. - `collect_tax_form` boolean โ€” Defaults to `true` if you use tax collection in your Routable workspace, `false` otherwise. - `contacts` ContactsNewCompanyContactBusiness[] โ€” A list of Contacts to add to the Company. Required if `is_customer` is `true`. - `allow_for_multiple_companies` boolean โ€” If set to true, Routable will bypass the validation of unique email addresses and allow the Contact to be created even if the email address is already used by a Contact on another Company. This value is **not** stored, so you will need to pass this value each time you want to create a Contact that may potentially have a duplicate email in the Routable system in order to disable email uniqueness validation and allow the Contact to be created. - `default_contact_for_company_management` 'actionable' | 'read_only' | 'none' โ€” This field controls how both the Routable Dashboard and API will autofill contacts for emails related to Company management such as inviting a Company to submit their payment information. - When set to `actionable`, the Contact will be able to take action on emails related to Company management. - When set to `read_only`, the Contact will only receive emails related to Company management. - When set to `none`, the Contact will not receive emails related to Company management. - `default_contact_for_payable_and_receivable` 'actionable' | 'read_only' | 'none' โ€” This field controls how both the Routable Dashboard and API will autofill contacts for emails related to Payables and Receivables. - When set to `actionable`, the Contact will be able to take action on emails related to Payables and Receivables. - When set to `read_only`, the Contact will only receive emails related to Payables and Receivables. - When set to `none`, the Contact will not receive emails related to Payables and Receivables. - `email` string, email โ€” The email for this Contact. Required if the `Company` is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `first_name` string โ€” The first name of this Contact. Required if the the `Company` is of type `personal` and/or is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `last_name` string โ€” The last name of this Contact. Required if the the `Company` is of type `personal` and/or is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `phone_number` string โ€” An E.164-formatted telephone number. - `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. - `display_name` string โ€” The Company's name for display in the Routable Dashboard. - `external_id` string โ€” A unique ID from your system to identify this Company. - `government_id` CompaniesGovernmentId, nullable โ€” Refers to the government ID for this business. The `type` and `value` will vary depending on country and company type. - `type` 'curp' | 'rfc', required โ€” The type of government ID being recorded. Only used for Companies of certain types in certain countries. - `curp` is used by Companies of type `personal` in Mexico. - `rfc` is used by Companies of type `business` in Mexico. - `value` string, required โ€” The value of the government ID. - `is_customer` boolean โ€” Whether this Company is a customer. One or both of `is_customer` and `is_vendor` must be `true`. - `is_vendor` boolean โ€” Whether the Company is a vendor. One or both of `is_customer` and `is_vendor` must be `true`. - `ledger` CompaniesCompanyLedgerMeta โ€” Stores this Company's metadata relating it to your accounting software. - `customer_id` string, nullable โ€” The unique ID for this customer in your accounting software. - `vendor_id` string, nullable โ€” The unique ID for this vendor in your accounting software. - `ledger_name` string โ€” If specified, this value will override and set the name of this Company in your accounting software. If unset, this will be set to the value of `business_name`. - `registered_address` CompaniesNewRegisteredAddress - `address_line_1` string, required โ€” The address' first line. - `address_line_2` string, nullable โ€” The address' second line. - `city` string, required โ€” The address' city. - `country` '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', required โ€” Country code in ISO 3166-1 Alpha-2 format. - `postal_code` string, required โ€” The address' postal code. - `state` string โ€” The address' state, province or territory. - `type` 'business', required โ€” The type of Company. - CompaniesNewCompanyPersonal - `acting_team_member` string, uuid, required โ€” The ID of a Team Member performing this action. This will be displayed in the Routable Dashboard. - `collect_tax_form` boolean โ€” Defaults to `true` if you use tax collection in your Routable workspace, `false` otherwise. - `contacts` ContactsNewCompanyContactPersonal[], required - `allow_for_multiple_companies` boolean โ€” If set to true, Routable will bypass the validation of unique email addresses and allow the Contact to be created even if the email address is already used by a Contact on another Company. This value is **not** stored, so you will need to pass this value each time you want to create a Contact that may potentially have a duplicate email in the Routable system in order to disable email uniqueness validation and allow the Contact to be created. - `default_contact_for_company_management` 'actionable' | 'read_only' | 'none' โ€” This field controls how both the Routable Dashboard and API will autofill contacts for emails related to Company management such as inviting a Company to submit their payment information. - When set to `actionable`, the Contact will be able to take action on emails related to Company management. - When set to `read_only`, the Contact will only receive emails related to Company management. - When set to `none`, the Contact will not receive emails related to Company management. - `default_contact_for_payable_and_receivable` 'actionable' | 'read_only' | 'none' โ€” This field controls how both the Routable Dashboard and API will autofill contacts for emails related to Payables and Receivables. - When set to `actionable`, the Contact will be able to take action on emails related to Payables and Receivables. - When set to `read_only`, the Contact will only receive emails related to Payables and Receivables. - When set to `none`, the Contact will not receive emails related to Payables and Receivables. - `email` string, email โ€” The email for this Contact. Required if the `Company` is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `first_name` string โ€” The first name of this Contact. Required if the the `Company` is of type `personal` and/or is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `last_name` string โ€” The last name of this Contact. Required if the the `Company` is of type `personal` and/or is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `phone_number` string โ€” An E.164-formatted telephone number. - `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. - `display_name` string โ€” The Company's name for display in the Routable Dashboard. The Company's `business_name` will be automatically set from the Contact's name. - `external_id` string โ€” A unique ID from your system to identify this Company. - `government_id` CompaniesGovernmentId, nullable โ€” Refers to the government ID for this business. The `type` and `value` will vary depending on country and company type. - `type` 'curp' | 'rfc', required โ€” The type of government ID being recorded. Only used for Companies of certain types in certain countries. - `curp` is used by Companies of type `personal` in Mexico. - `rfc` is used by Companies of type `business` in Mexico. - `value` string, required โ€” The value of the government ID. - `is_customer` boolean โ€” Whether this Company is a customer. One or both of `is_customer` and `is_vendor` must be `true`. - `is_vendor` boolean โ€” Whether the Company is a vendor. One or both of `is_customer` and `is_vendor` must be `true`. - `ledger` CompaniesCompanyLedgerMeta โ€” Stores this Company's metadata relating it to your accounting software. - `customer_id` string, nullable โ€” The unique ID for this customer in your accounting software. - `vendor_id` string, nullable โ€” The unique ID for this vendor in your accounting software. - `ledger_name` string โ€” If specified, this value will override and set the name of this Company in your accounting software. If unset, the Contact's `first_name` and `last_name` will be used. - `registered_address` CompaniesNewRegisteredAddress - `address_line_1` string, required โ€” The address' first line. - `address_line_2` string, nullable โ€” The address' second line. - `city` string, required โ€” The address' city. - `country` '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', required โ€” Country code in ISO 3166-1 Alpha-2 format. - `postal_code` string, required โ€” The address' postal code. - `state` string โ€” The address' state, province or territory. - `type` 'personal', required โ€” The type of Company. ## Response `201` OK - CompaniesCompany - `object` 'Company', required โ€” The objectโ€™s type (`Company`). - `id` string, uuid, required โ€” The Company ID. - `business_name` string, required โ€” The Company's business name for banking and tax purposes. - `collect_tax_form` boolean โ€” Defaults to `true` if you use tax collection in your Routable workspace, `false` otherwise. - `contacts` ContactsContactList - `object` 'List', required โ€” The objectโ€™s type (`List`). - `links` SharedListLinks, required โ€” Related links. - `self` string, uri-reference, required โ€” Link to this object. - `next` string, uri, nullable โ€” Link to the next page of results. - `prev` string, uri, nullable โ€” Link to the previous page of results. - `results` ContactsContact[], required - `object` 'Contact', required โ€” The objectโ€™s type (`Contact`). - `id` string, uuid, required โ€” The Contact ID. - `default_contact_for_company_management` 'actionable' | 'read_only' | 'none' | '' | 'self_managed', required โ€” This field controls how both the Routable dashboard and API will autofill contacts for emails related to company management such as inviting a company to submit their payment information. - When set to `actionable`, the contact will be able to take action on emails related to company management. - When set to `read_only`, the contact will only receive emails related to company management. - When set to `none`, the contact will not receive emails related to company management. - `default_contact_for_payable_and_receivable` 'actionable' | 'read_only' | 'none' | '' | 'self_managed', required โ€” This field controls how both the Routable dashboard and API will autofill contacts for emails related to payables and receivables. - When set to `actionable`, the contact will be able to take action on emails related to payables and receivables. - When set to `read_only`, the contact will only receive emails related to payables and receivables. - When set to `none`, the contact will not receive emails related to payables and receivables. - `email` string, email, nullable โ€” The email for this contact. - `first_name` string โ€” The first name of this contact. - `is_archived` boolean, required โ€” Whether the contact is archived. - `last_email_delivery_problem` 'auto_responder' | 'hard_bounce' | 'refused' | 'soft_bounce' | 'spam_complaint' | 'spam_notification' | 'transient' | 'unknown', nullable โ€” Describes an error that was encountered the last time an email was sent to this Contact via the Routable application. If the last email had no errors, this value will be `null`. | Value | Description | | ----------------- | -----------------------------------| | auto_responder | Automatic email responder (ex: "Out of Office" or "On Vacation"). | | hard_bounce | The server was unable to deliver your message (ex: unknown user, mailbox not found). | | refused | Email service has asked that the address not be used. Which could be because it is not a valid email address, or the recipient has requested an address change. | | soft_bounce | Temporarily unable to deliver the message (i.e. mailbox full, account disabled, exceeds quota, out of disk space). | | spam_complaint | The subscriber explicitly marked this message as spam. | | spam_notification | The message was delivered, but was either blocked by the user, or classified as spam, bulk mail, or had rejected content. | | transient | The server temporarily could not deliver your message (ex: Message is delayed due to network troubles). This may be re-tried and eventually resolve or become a different error.| | unknown | An unknown error occurred when sending the previous email. | - `last_name` string โ€” The last name of this contact. - `phone_number` string, required โ€” An E.164-formatted telephone number. - `phone_number_country` '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' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | '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' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | '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' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | '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' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'XK' | 'XX' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required โ€” Country code in ISO 3166-1 Alpha-2 format. - `links` ContactsContactLinks, required โ€” Related links. - `company` string, uri-reference, required โ€” Link to this Contact's Company. - `invitation_url` string, uri โ€” The URL for Company onboarding, generated by a call to the `Invite a Company` endpoint. - `self` string, uri-reference, required โ€” Link to this object. - `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_at` string, date-time, required โ€” The date the Company was created. - `display_name` string, required โ€” The Company's name for display in the Routable Dashboard. - `external_id` string, nullable, required โ€” A unique ID from your system to identify this Company. - `is_archived` boolean โ€” Whether this Company has been archived. - `is_customer` boolean, required โ€” Whether this Company is a customer. - `is_vendor` boolean, required โ€” Whether this Company is a vendor. - `ledger` CompaniesCompanyLedgerMeta, required โ€” Stores this Company's metadata relating it to your accounting software. - `customer_id` string, nullable โ€” The unique ID for this customer in your accounting software. - `vendor_id` string, nullable โ€” The unique ID for this vendor in your accounting software. - `registered_address` union - CompaniesRegisteredAddress, nullable - `address_line_1` string, required โ€” The address' first line. - `address_line_2` string, nullable โ€” The address' second line. - `city` string, required โ€” The address' city. - `country` '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', required โ€” Country code in ISO 3166-1 Alpha-2 format. - `postal_code` string, required โ€” The address' postal code. - `state` string โ€” The address' state, province or territory. - `object` 'Address', required โ€” The objectโ€™s type (`Address`). - `id` string, uuid, required โ€” The Registered Address ID. - object, nullable - `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. - `links` CompaniesCompanyLinks, required โ€” Related links. - `self` string, uri-reference, required โ€” Link to this object. - `compliance_checks` string, uri-reference, required โ€” Link to this Company's Compliance Reports. - `contacts` string, uri-reference, required โ€” Link to this Company's Contacts. - `payables` string, uri-reference, required โ€” Link to this Company's Payables. - `payment_methods` string, uri-reference, required โ€” Link to this Company's Payment Methods. - `receivables` string, uri-reference, required โ€” Link to this Company's Receivables. - `tax_forms` string, uri-reference, required โ€” Link to this Company's most recent TaxForm. --- [API](https://skmtc.net/routable/apis/routable-api.md) ยท [All operations](https://skmtc.net/routable/apis/routable-api/llms.txt) ยท [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routable/routable-api/revisions/9f17a8bc982a/schema)