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

# Account

> Read your current account, manage your organization's accounts and membership, and set notification preferences on the storefront side

The **account** endpoints expose the organization behind your storefront. Use them to read your current account context, list the accounts you can switch into, provision and remove accounts under your organization, set the registered account domain, control domain auto-join, and manage your notification opt-ins.

All examples use the storefront base URL:

```
https://api.interchange.io/api/v2/storefront
```

Authenticate every request with `Authorization: Bearer $SCOPE3_API_KEY`. Your account context is resolved from the API key. Account-management, domain, and membership operations require the `ADMIN` role on the target account.

## Key concepts

* **Organization/account hierarchy.** A standalone account becomes an organization the first time you create an account under it; the new account inherits the organization's contract. Only `CHILD`-type accounts can be deleted, and only when they have no linked resources.
* **Registered domain.** An account can carry one `customerDomain`. It gates domain auto-join and, for `SELLER` accounts, seeds the auto-created storefront's publisher and operator domain when supplied.
* **Storefront operator domain.** A storefront has its own `operatorDomain`, which is the canonical domain the storefront operates as for AAO and buyer-facing identity. It may differ from the account's `customerDomain`. Updating `customerDomain` syncs the storefront only while the storefront operator domain is missing or still mirrors the account's previous registered domain.
* **Domain auto-join.** Users with a verified matching-domain email join as members without admin approval when `allowDomainAutoJoin` is true. It defaults on for top-level organizations and off for child accounts, and requires a `customerDomain` to be set. Admins can explicitly override the default.
* **Notification opt-ins.** Preferences are a full set of `{ notificationType, channel }` pairs. The update call replaces all existing opt-ins.

## Task reference

<CardGroup cols={2}>
  <Card title="Get current account" href="/v2/storefront/account/tasks/get-current-account" icon="id-card">
    Authenticated account context
  </Card>

  <Card title="List accounts" href="/v2/storefront/account/tasks/list-customer-accounts" icon="list">
    Accounts you can switch into
  </Card>

  <Card title="Create account" href="/v2/storefront/account/tasks/create-child-account" icon="plus">
    Provision a buyer or seller account
  </Card>

  <Card title="Delete account" href="/v2/storefront/account/tasks/delete-child-account" icon="trash">
    Hard-delete an empty account
  </Card>

  <Card title="Update account domain" href="/v2/storefront/account/tasks/update-customer-domain" icon="globe">
    Set the account's registered domain
  </Card>

  <Card title="Get membership" href="/v2/storefront/account/tasks/get-membership" icon="users">
    Read domain auto-join setting
  </Card>

  <Card title="Update membership" href="/v2/storefront/account/tasks/update-membership" icon="user-gear">
    Toggle domain auto-join
  </Card>

  <Card title="Get notification preferences" href="/v2/storefront/account/tasks/get-notification-preferences" icon="bell">
    Read your opt-ins
  </Card>

  <Card title="Update notification preferences" href="/v2/storefront/account/tasks/update-notification-preferences" icon="bell-on">
    Replace your opt-ins
  </Card>
</CardGroup>

## Related

<CardGroup cols={2}>
  <Card title="All account tasks" href="/v2/storefront/account/tasks" icon="list-check">
    Every operation in one place
  </Card>

  <Card title="Activity & reporting" href="/v2/storefront/activity/overview" icon="chart-line">
    Audit feed and reporting metrics
  </Card>

  <Card title="Errors" href="/v2/reference/errors" icon="triangle-exclamation">
    Shared error contract
  </Card>
</CardGroup>
