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
businesswhen they are acting as a sole proprietorship, LLC, or corporation. - You would create a company as
personalwhen 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_namefor your company is incorrect, it can cause issues for payments.
- The
business_nameis the legal name of the Company entity. For Companies of typebusiness, you can set it in the
Create Company payload directly. Forpersonaltype Companies, it will be automatically set by concatenating theContact's
first_nameandlast_name. - The
display_nameis what will show in the Routable Dashboard. It defaults to the value ofbusiness_nameunless explicitly
provided. - The
ledger_nameis what will be recorded for this Company in your linked accounting software. It defaults to the value of
business_nameunless 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.
