Skip to main content
POST
/
v1
/
businesses
Create business
curl --request POST \
  --url https://sandbox.layerfi.com/v1/businesses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_id": "<string>",
  "legal_name": "<string>",
  "tin": "<string>",
  "us_state": "AL",
  "country": "AF",
  "entity_type": "SOLE_PROP",
  "phone_number": "<string>",
  "sms_enabled": true,
  "sms_categorization_start_date": "2023-11-07T05:31:56Z",
  "activation_at": "2023-11-07T05:31:56Z",
  "internal_bank_account_ids": [
    {
      "unit_id": "<string>",
      "account_name": "My Unit account",
      "opening_balance_init_to_zero": true,
      "opening_balance_do_not_init": true
    }
  ],
  "unit_ids": [
    {
      "unit_id": "<string>",
      "account_name": "My Unit account",
      "opening_balance_init_to_zero": true,
      "opening_balance_do_not_init": true
    }
  ],
  "plaid_items": [
    {
      "item_id": "<string>",
      "access_token": "<string>",
      "sync_transactions": true,
      "institution_plaid_id": "<string>"
    }
  ],
  "plaid_processor_tokens": [
    {
      "processor_token": "<string>"
    }
  ],
  "skip_onboarding": true,
  "industry": "<string>",
  "naics_code": "<string>",
  "stripe_connect_accounts": [
    {
      "stripe_id": "<string>"
    }
  ],
  "default_reporting_basis": "CASH"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "Business",
  "external_id": "test-acme-id",
  "legal_name": "ACME LLC",
  "tin": "<string>",
  "us_state": "AL",
  "country": "AF",
  "entity_type": "SOLE_PROP",
  "industry": "<string>",
  "phone_number": "+16504651359",
  "naics_code": "484110",
  "sms_enabled": true,
  "sms_stopped": true,
  "sms_categorization_start_date": "2023-11-07T05:31:56Z",
  "activation_at": "2023-11-07T05:31:56Z",
  "imported_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "archived_at": "2023-11-07T05:31:56Z",
  "last_synced_at": "2023-11-07T05:31:56Z",
  "unit_accounts": [
    {
      "id": "111111",
      "importedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "plaid_items": [
    {
      "accessToken": "access-sandbox-a67d0be8-abcd-1234-5678-14fc7bc65366",
      "institution": {
        "id": "ins_1",
        "name": "Bank of America",
        "logo": "iVBORw0KGgoAAAANSUhEUgAAAJgAAACYCAMAAAAvHNATAAAA6lBMVEUAAAD////////////////////////////////////////////////////////////////////////////////qUmn74ubnNVD4xc398fLlJkT1qLTf4+zpRFzrYHb509rvfY7xjJuAkLTzmqfxi5vzmai/x9lBWY7v8fXtb4LjGDftboIhPXwBIWkRL3P3t8D2t8HsYHbvfo7P1ePzmqigrMeQnr3oRF1RZphhdaGQnb0xS4Wfq8dgdKHuboL609lwgqtgdaFwgqqvutCfrMevudCQnr5BWY/pQ11RZpeQnb70qLRRZ5f98fO30r7oAAAAFHRSTlMA3yDvv0AQn2DPcFCAoJAwf4+vXxXsOc8AAAYDSURBVHhe7ZwHcus4EESZo5L9h1nROfvnvDmn+19nvevvoqimQAKgRFTtvguwa7pnIEIgNFmM0DtwLV/X6V903bLcQWCPtR4ZB65v0jZ8N7B7EGUHFmhCTCvYZ+kc+8Ck1uhuqO0FUNWM6e7cVGdikhC6Z+yyWK5J4ri7kmZbJIllKyILsbo21ABZShjqTKhDJo7WEaFOnaJ73ZTrkAAV/AxNAhQomnNAO+JAKmmGTjtDl7DzmUk7xBS2c0I7ZiIWL5d2jiuiy6c94BuqxB5bQBVdqEwVXahMFV2oTA1diN52EfBpz/jtlLm0d1zhea/AGuBRLzxrDL5JvWA2tKYDDalIax5QbxwoEjAkVGOyIqajxgRDDhUxEgmbOlKxzpxQ7wxqk08KYKiRfMRSpGCIDcIsIiVLZpMkWfEyn13eZ9Il67Rg6Sq6+kJ0+o1cybpM2PN5frVG8jKVKVm3LZku31W0XQprcztvybiIqnWL5ddyT6hIUXSabnbAfF1bVMSS418nXrLVY6zyFxsPz6p1E7DUlJgVacQqTFwk65Zyl80WjX4cXW0yO61qS6/XhXMOkJH2hMmf88cBAXWDsuWXRSYc/5BESK+TTW0v7quGz09SEsEGJ6W1JZcxyTPi6smLn89qtZWeNvVhlhYxT1+OW8k6uru9vfvzzZSAItrshJiQ7DTK/5Edt/cyoEam390+8Qtqo3jd0vwE0x6Xi3wraQH8sNgmq+T8jOp4Gl3RaVZTq2oOV3G7nxhms4koC3kePchKGbMYpbFDZgvKQtK0duFC8uWC2IybIrYu6+anqr93H6ZtFi5UBfqRgD3Fzm5KWXdHNbH7UDqLyXpXp+pF2nrv098q6/y25Oii4m9ZxjeEoIfYGWz8B2HbwlVpxSnErpT2QztZaCE7/ePmzN9UDPvx0d/S4ovtsmC6AenxtldyuzlcF+Avr6worVf18sHwpCCEwrqmnJ5vdfHb2wrvp+KystVTd/waE+BpA9C13cWPpb8w1kAWe1FPK298uEyNtCG6WPL9ulGvNlx8C8sSyMJH1q/76KdbrpTo1aczcBE14zhFWWg3klT9tDaEfYKKQCHBYngPwGyhLCSKq4NMpwqfz1uE/u4InyYpa3NF0PGVcvoVs1yl5pI0QWeYspqHnK4RMj16zyrXW3QRn8QpC9GITXO5XqM5y4xTFrcwbMbNci2iduEqEoYsAWGvNprxFVVZoTHHzC0FlCUk7CN7di1mOLkyAuI5pywUhh3Kml0rVi9iuDCILJredqe/QeqhGZnPSpPmcYrgHEM+30Dq65txtmBuDGF/sIX51MjRDaQ+wwc+ji5Uj+QFMYC1ksH09wv0p7lc6azWRch8vbAh8bPEdBGQLTnCBbjaiHjB3CQpM/TYts0M+Des0xybkV0udLGZQAtlbczv25YrWvBsKhpCNmJmsFy4VnEw5twZjq9hSLQs1zwjHvhPixVJQ5aXQqHHLQKYFxxFizL0esaxLrI3VQLi5fhLXx4zRj13uXAbakzcxEm9O9lcoly4O2wSPyfQjZB6KBcHpvi/zjEBK9FmRCz2djrvhEPyP0iIQPYAAdtGsJtnvAqFrKWNxySIrj0yIkmyOhuTheSxWHkvF3U2fp3JnyNz5Lx8ncuu2DgsuvAylbcRnezEyyKRtxHHfhd9GSdS3Yg9WTIgOU5gDZLA00qE44/7wrO40+OAQwLE7Fxm3Z7tt0mWv67hdVwMAw+2SQctv+/+LKBN8jyPSR5b3cOTWDJFTugqWTJX4SPNyIB6Z6D0sXkkpJ7xtC0cKpV85lquyueMoSJGIiPqjZHSn5ip/1Ee4ikSMGSgyMhHhrR3hkp87I/4GsBozf8/FNcN9T/5V/+SBPWvlUAMv5eP/RWZZ0NHE2HQ47xn4/V8PY76Fwohzoh2xMjR5PD0ndgYatIYO+jOQyiXEkXTQ60jnE4HxwDK1Z+f6t8LaNn/mQse0VC1bhI1RDvUhMh3jj00uVWNbG0vhEOdS5Wj7Y9xy6t9e7p3eOhv1+S7Qb9XNdvBwLWs8vpo33JHXig9Rv8G+MxS+LqktYUAAAAASUVORK5CYII="
      },
      "itemId": "V3jvONy9xbroJVaRnm6oiAqVMv5Qz3TrNyLdL",
      "syncTransactions": true
    }
  ],
  "plaid_processor_tokens": [
    {
      "processor_token": "processor-sandbox-d8e791d1-1234-9876-a207-69acca316045"
    }
  ],
  "previously_imported": true,
  "stripe_connect_accounts": [
    {}
  ],
  "default_reporting_basis": "CASH"
}

​
Response Status Codes

  • 201 Created - A new business was successfully created
  • 200 OK - An existing business was found and returned:
    • Archived business with matching phone number was unarchived
    • Non-archived business with matching external ID was found
  • 400 Bad Request - Phone number matches an existing non-archived business with a different external ID
The response includes previously_imported: true when an existing business is returned.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Content-Type
string

Content-Type must be set to application/json

Body

application/json
​
external_id
string

Unique ID of the business in your system for linking purposes. Idempotency key.

​
legal_name
string

Legal name of the business as it has been registered.

​
tin
string | null

Tax Identification Number for the business.

​
us_state
enum<string>

The state this business is incorporated in.

Available options:
AL,
AK,
AZ,
AR,
CA,
CO,
CT,
DE,
DC,
FL,
GA,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
OH,
OK,
OR,
PA,
PR,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VI,
VA,
WA,
WV,
WI,
WY
​
country
enum<string>

2 letter ISO country code representing the country this business is incorporated in. Defaults to US.

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

Entity type of the business. Used to determine tax filing status.

Available options:
SOLE_PROP,
C_CORP,
LLC,
S_CORP,
PARTNERSHIP,
NON_PROFIT,
TRUST
​
phone_number
string

Phone number used for SMS based categorization.

​
sms_enabled
boolean

Whether SMS is enabled for this business

​
sms_categorization_start_date
string<date-time>

Date when SMS categorization starts for this business.

​
activation_at
string<date-time>

The activation timestamp represents the time at which Layer should begin displaying accounting data. Data before this time will not be displayed to users. This field is important for businesses migrating over from other accounting platforms. Defaults to Jan 1 of the current year.

​
internal_bank_account_ids
object[]

List of internal bank account identifiers to associate with this business.

​
unit_ids
object[]

List of unit account identifiers to associate with this business.

​
plaid_items
object[]

Plaid items to link to this business.

​
plaid_processor_tokens
object[]

Plaid processor tokens to link to this business.

​
skip_onboarding
boolean

Whether to skip the onboarding process for this business.

​
industry
string

Industry classification for the business.

​
naics_code
string | null

6-digit NAICS code used to identify the business's industry.

​
stripe_connect_accounts
object[]

List of Stripe Connect accounts associated with this business.

​
default_reporting_basis
enum<string> | null

Default accounting basis for financial reports.

Available options:
CASH,
ACCRUAL

Response

​
id
string<uuid>

Unique identifier for the business.

​
type
string

Resource type. Value will be “Business”.

Example:

"Business"

​
external_id
string

Unique ID of the business in your system for linking purposes. Idempotency key.

Example:

"test-acme-id"

​
legal_name
string

Legal name of the business as it has been registered.

Example:

"ACME LLC"

​
tin
string | null

Tax Identification Number for the business.

​
us_state
enum<string>

The state this business is incorporated in.

Available options:
AL,
AK,
AZ,
AR,
CA,
CO,
CT,
DE,
DC,
FL,
GA,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
OH,
OK,
OR,
PA,
PR,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VI,
VA,
WA,
WV,
WI,
WY
​
country
enum<string>

2 letter ISO country code representing the country this business is incorporated in. Defaults to US.

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

Entity type of the business. Used to determine tax filing status.

Available options:
SOLE_PROP,
C_CORP,
LLC,
S_CORP,
PARTNERSHIP,
NON_PROFIT,
TRUST
​
industry
string

Industry classification for the business.

​
phone_number
string

Phone number used for SMS based categorization.

Example:

"+16504651359"

​
naics_code
string | null

6-digit NAICS code used to identify the business's industry.

Example:

"484110"

​
sms_enabled
boolean

Whether SMS is enabled for this business

​
sms_stopped
boolean

Whether this business has responded to Layer's SMS with "STOP"

​
sms_categorization_start_date
string<date-time>

Date when SMS categorization starts for this business.

​
activation_at
string<date-time>

The activation timestamp represents the time at which Layer should begin displaying accounting data. Data before this time will not be displayed to users. This field is important for businesses migrating over from other accounting platforms. Defaults to Jan 1 of the current year.

​
imported_at
string<date-time>

Time when the business entity was created in Layer. Eligible sort key.

​
updated_at
string<date-time> | null

Time when the business's information was last updated in Layer. Eligible sort key.

​
archived_at
string<date-time> | null

Time when the business was archived, if applicable.

​
last_synced_at
string<date-time> | null

Time when the business data was last synced with external systems.

​
unit_accounts
object[]

List of unit accounts associated with this business.

​
plaid_items
object[]

Plaid items linked to this account.

​
plaid_processor_tokens
object[]

Plaid processor tokens linked to this account

​
previously_imported
boolean | null

True if an archived business with the same phone number was unarchived during creation.

​
stripe_connect_accounts
object[]

List of Stripe Connect accounts associated with this business.

​
default_reporting_basis
enum<string> | null

Default accounting basis for financial reports.

Available options:
CASH,
ACCRUAL