Add (or upsert) a nexus registration
POST /v1/portability/nexus
Adds a new nexus record or upserts an existing one for the calling account. Idempotent: posting the same (state, nexus_type) twice updates the second time rather than duplicating.
Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”A single nexus registration record. Each represents one state in which the account has tax-collection obligation (physical presence, economic threshold, or marketplace facilitator).
object
Two-letter USPS state code.
Reason for collection in this state. physical = office/warehouse/employee/inventory presence; economic = exceeded the state’s sales/transaction threshold; marketplace = marketplace facilitator obligation. Default is physical.
Responses
Section titled “ Responses ”Nexus record created or upserted.
object
Body validation failed (invalid state, invalid nexus_type, malformed date).
Missing or invalid API key.
Validation Error