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

# Update Profile Settings

> Update the vendor's storefront profile using strict tab-based sections

<Note>
  **V2 Preview** — This endpoint is part of the V2 API preview. Breaking changes may occur.
</Note>

## Overview

Update the authenticated vendor's profile settings using strict tab-based payload sections. Unknown fields are rejected. Social-media values are normalized to https URLs where applicable. Vendor scope required.

## Request Body

<ParamField body="information" type="object">
  `businessLogo`, `businessLogoId`, `profileBanner`, `profileBannerId`, `description`, `profileDescription`, `businessAddress { address1, address2, city, state, postalCode, country }`.
</ParamField>

<ParamField body="socialMedia" type="object">
  `facebook`, `instagram`, `twitter`, `pinterest`, `snapchat`, `youtube`, `linkedin`, `whatsapp`, `tiktok`, `website`.
</ParamField>

<ParamField body="contactInfo" type="object">
  `email`, `phone`, `location`.
</ParamField>

<ParamField body="policies" type="object">
  `shippingPolicy`, `returnsPolicy`.
</ParamField>

<ParamField body="vacation" type="object">
  `enabled` (boolean), `timeRange` (2-element array of date strings), `message`.
</ParamField>

<ParamField body="others" type="object">
  `hasTax` (boolean), `vendorTaxRate` (number 0–100).
</ParamField>

## Response

```json 200 theme={null}
{ "success": true, "data": { /* updated profile sections */ } }
```

## Example

```bash theme={null}
curl -X PUT "https://staging-api.puppetvendors.com/settings/profiles" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "information": {
      "description": "Handmade artisan products"
    },
    "socialMedia": {
      "instagram": "myshop",
      "website": "example.com"
    },
    "vacation": {
      "enabled": true,
      "timeRange": ["04/01/2026", "04/10/2026"],
      "message": "Back soon"
    },
    "others": {
      "hasTax": true,
      "vendorTaxRate": 8.25
    }
  }'
```

### More Examples

**Update business info and social media**

```bash theme={null}
curl -X PUT "https://staging-api.puppetvendors.com/settings/profiles" \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -d '{
    "information": {
      "description": "Premium handcrafted goods since 2020",
      "businessAddress": "123 Artisan Way, Portland, OR"
    },
    "socialMedia": {
      "instagram": "https://instagram.com/acmeco",
      "website": "https://acmeco.com"
    }
  }'
```

**Set vacation mode**

```bash theme={null}
curl -X PUT "https://staging-api.puppetvendors.com/settings/profiles" \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -d '{
    "vacation": {
      "enabled": true,
      "timeRange": ["2026-06-15T00:00:00Z", "2026-07-01T00:00:00Z"],
      "message": "We'\''re on vacation! Orders placed now will ship after July 1st."
    }
  }'
```