# Record a physical presence

> POST /physical-nexus

Source: https://docs.trykintsugi.com/reference/2026-07-21/record-a-physical-presence

POST /physical-nexus

Record a physical presence

Record a physical presence in one jurisdiction. Recording a presence can establish nexus there, so the jurisdiction's exposure is recalculated. One record exists per organization, jurisdiction and category: a second create for the same three returns 200. A category the jurisdiction does not accept returns 400; get the accepted set from `GET /physical-nexus/categories`.

Category: Physical nexus

Request body:
countryCode (string, required) - ISO 3166-1 alpha-2 country of the jurisdiction.
stateCode (string, required) - State or province code within `countryCode`. `FD` for a federal jurisdiction.
category (PublicPhysicalNexusCategoryEnum, required) - Kind of physical presence to record. A category the jurisdiction does not accept returns 400; get the accepted set from `GET /physical-nexus/categories`.
  allowed values: PHYSICAL_BUSINESS_LOCATION, TELECOMMUTING_OR_REMOTE_EMPLOYEE, WARRANTY_AND_REPAIR_SERVICES, CATALOGUE_DISTRIBUTION_OR_ADVERTISING_MATERIAL, DELIVERY_BY_COMMON_CARRIER, DELIVERY_BY_OWN_VEHICLES, IN_STATE_SALES_PERSON, INDEPENDENT_CONTRACTOR_OR_THIRD_PARTY_SALES_PERSON, WAREHOUSE_AND_INVENTORY_PRESENCE, EMPLOYEES_AGENTS_CONTRACTORS, OWN_LEASE_A_PROPERTY, INVENTORY (and 14 more, see the reference page)
startDate (string, required) - Date the physical presence began, as YYYY-MM-DD.
endDate (string) - Date the physical presence ended, as YYYY-MM-DD. Omit it or send `null` while the presence is open-ended. Must not precede `startDate`.
externalId (string) - Your identifier for this record in an external system.
street1 (string) - Street address of the location.
street2 (string) - Suite, unit, or other address detail.
city (string) - City of the location.
postalCode (string) - ZIP or postal code of the location.

Response fields:
id (string, required) - Opaque unique identifier for this physical nexus.
organizationId (string, required) - Organization this physical nexus belongs to. Always present so a portfolio list that spans organizations stays unambiguous.
organizationName (string) - Display name of the owning organization. `null` if the name could not be loaded.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt