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

# Upsert Seller Address

> Create or update a seller's address.

Creates the seller's address if none exists, otherwise updates it.

## Path parameters

**id** `string` *required*

The seller's ID.

## Query parameters

**fields** `string`

Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.

## Body parameters

**name** `string`

Label for the address.

**company** `string`

Company name.

**first\_name** `string`

First name of the contact person.

**last\_name** `string`

Last name of the contact person.

**address\_1** `string`

First address line.

**address\_2** `string`

Second address line.

**city** `string`

City.

**country\_code** `string`

Two-letter ISO country code.

**province** `string`

Province or state.

**postal\_code** `string`

Postal code.

**phone** `string`

Phone number for the address.

**metadata** `object`

Custom key-value data.

**additional\_data** `object`

Extra data passed to workflow hooks.

## Response

**seller** `object`

**properties**

**id** `string`

The seller's ID.

**address** `object`

**properties**

**address\_1** `string`

First address line.

**city** `string`

City.

**country\_code** `string`

Two-letter ISO country code.

**postal\_code** `string`

Postal code.

**updated\_at** `string`

Last update timestamp.

```bash cURL theme={null}
curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/address' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "address_1": "123 Market St",
    "city": "San Francisco",
    "country_code": "us",
    "postal_code": "94103"
  }'
```

```ts JS Client theme={null}
const { seller } = await client.admin.sellers.$id.address.mutate({
  $id: "sel_01HXYZABCDEF",
  address_1: "123 Market St",
  city: "San Francisco",
  country_code: "us",
  postal_code: "94103",
})
```

```json 200 theme={null}
{
  "seller": {
    "id": "sel_01HXYZABCDEF",
    "name": "Acme",
    "status": "open",
    "address": {
      "address_1": "123 Market St",
      "city": "San Francisco",
      "country_code": "us",
      "postal_code": "94103"
    },
    "updated_at": "2026-06-12T10:30:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.