> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a worker address

> Add an address use to a worker.

### Parameters

<ParamField body="worker" type="string" required>
  ID of the worker this address belongs to.
</ParamField>

<ParamField body="purpose" type="string" required>
  Address purpose. One of `residential`, `business`, or `shipping`.
</ParamField>

<ParamField body="place" type="string">
  Existing place ID from one of this worker's addresses. Use this to make two
  purposes point at the same place, such as shipping to the residential address.
</ParamField>

<ParamField body="starts" type="string">
  Effective start date. Omit when the address was effective before Plane
  tracked the worker's address history.
</ParamField>

<ParamField body="line1" type="string">
  Address line 1. Provide address fields when you are not using `place`.
</ParamField>

<ParamField body="line2" type="string">
  Address line 2.
</ParamField>

<ParamField body="city" type="string">
  City.
</ParamField>

<ParamField body="state" type="string">
  State, province, or subdivision, when applicable.
</ParamField>

<ParamField body="postal_code" type="string">
  Postal code.
</ParamField>

<ParamField body="country" type="string">
  Two-letter country code.
</ParamField>

### Returns

Returns the created [Worker address object](/reference/worker-addresses/object).
When a value-based request exactly matches a place already referenced by this
worker's addresses, Plane reuses that place and returns its ID in `place`.
When an address records a successor row for the same purpose, Plane immediately
writes the previous row's `ends` as the day before the new row's `starts`, even
if the successor starts in the future.

<ResponseExample>
  ```json Request theme={null}
  {
    "worker": "wr_8oWZpQ2rL4sk",
    "purpose": "residential",
    "starts": "2026-07-04",
    "line1": "100 Congress Ave",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701",
    "country": "US"
  }
  ```

  ```json Response theme={null}
  {
    "id": "wra_8oWZpQ2rL4sk",
    "object": "worker_address",
    "worker": "wr_8oWZpQ2rL4sk",
    "purpose": "residential",
    "starts": "2026-07-04",
    "ends": null,
    "current": true,
    "place": "plc_8oWZpQ2rL4sk",
    "line1": "100 Congress Ave",
    "line2": null,
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701",
    "country": "US",
    "created": "2026-07-04T12:00:00Z",
    "updated": "2026-07-04T12:00:00Z"
  }
  ```
</ResponseExample>