Upsert Seller Address

POST

admin

sellers

{id}

address

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"
  }'

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",
})

{
  "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"
  }
}

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

Path parameters

string

required

The seller’s ID.

Query parameters

string

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

Body parameters

string

Label for the address.

string

Company name.

string

First name of the contact person.

string

Last name of the contact person.

string

First address line.

string

Second address line.

string

City.

string

Two-letter ISO country code.

string

Province or state.

string

Postal code.

string

Phone number for the address.

object

Custom key-value data.

object

Extra data passed to workflow hooks.

Response

object

Show properties

string

The seller’s ID.

object

Show properties

string

First address line.

string

City.

string

Two-letter ISO country code.

string

Postal code.

string

Last update timestamp.

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"
  }'

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",
})

{
  "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"
  }
}

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"
  }'

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",
})

{
  "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"
  }
}

Overview

Panel extensions

Admin API

Vendor API

Store API

Configuration

Path parameters

Query parameters

Body parameters

Response

​Path parameters

​Query parameters

​Body parameters

​Response

Path parameters

Query parameters

Body parameters

Response