Skip to main content
POST
Create tax profile
To enable the Tax Estimates feature for your customers, request access from your Layer representative.
Creates the business’s tax profile: the inputs that drive every Tax Estimates calculation. Call this once when the user first configures their tax settings; subsequent updates should use Update tax profile. The request body is an ApiTaxProfile object covering federal filing status, W-2/withholding inputs, state and state withholding, deductions configuration (home office, vehicle/mileage), and optional business revenue/expense estimates. See the Get tax profile response schema for the full field list. Returns 400 if a profile already exists for the business. In that case use Update tax profile (PATCH) instead. Once created, user_has_saved_tax_profile becomes true and the MISSING_PROFILE item is removed from the tax checklist.

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.

Path Parameters

businessId
string<uuid>
required

The UUID of the business.

Body

application/json

Tax profile configuration for a business.

type
string

Resource type.

Example:

"Tax_Profile"

tax_country_code
string | null

The ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Z]{2}$
Example:

"US"

us_configuration
object | null

US-specific tax configuration.

ca_configuration
object | null

Canadian-specific tax configuration (future use).

user_has_saved_tax_profile
boolean

Whether the user has explicitly saved their tax profile configuration.

Response

Tax profile created successfully.

data
object
required

Tax profile configuration for a business.