SureTaxAPI
POST LegalEntities
Overview
The POST LegalEntities API endpoint facilitates the process of creating a new legal entity. The new legal entity will be active immediately upon creation and the entity code will be shown in the response.
OperationId: POST LegalEntities
Authorization Method(s): OAuth
Verb: POST
End Point: /Account/LegalEntities
Example Request
The following is an json request for this operation.
{
"parentEntityCode": "000001817",
"entityName": "testentity",
"contactNumbers": [
{
"contactNumberType": "BusinessOther2",
"contactPhonenumber": "8148128234"
}
],
"entityAddress": {
"address1": "address1",
"address2": "string",
"city": "city",
"state": "TX",
"country": "US",
"zipcode": "12345",
"plus4": "1234"
},
"contactPersons": [
{
"personType": "Technical",
"personName": "testname",
"emailAddress": "test@test.com"
}
],
"fein": "1234567890",
"website": "www.test.com",
"notificationBusinessEmail": "business@wk.com",
"entityDescription": "entity description"
}
Overview
Represents the response containing the new legal entity.
Example Response
The following is an example response you can expect for this operation
{
"data": [
{
"legalEntityCode": "000001847",
"entityName": "test entity"
}
]
}
Response codes in an API indicate the outcome of a request. They are three-digit numbers returned by the server to help the client understand if the request was successful, encountered an error, or needs further action. This operation has the following possible responses.
code | description |
---|---|
201 | The API Response contains the newly created legal entity code. |
400 | Bad request. Invalid parameters or missing required information. |
401 | Unauthorized access. The request requires user authentication. |
500 | Internal server error. An error occurred while processing the request. |