---
title: >-
  Support for market-aware auth URLs in Customer Account API - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/support-for-market-aware-auth-urls-in-customer-account-api
  md: >-
    https://shopify.dev/changelog/support-for-market-aware-auth-urls-in-customer-account-api.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Customer Account API
      handle: customer-account-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-02-23T07:10:58-05:00'
  postedAt: '2026-02-24T12:00:00-05:00'
  updatedAt: '2026-03-02T09:37:40-05:00'
  effectiveAt: '2026-02-24T12:00:00-05:00'
---

February 24, 2026

Tags:

* Customer Account API

# Support for market-aware auth URLs in Customer Account API

You can now pass `locale` and `region_country` parameters to the Customer Account API authorization endpoint to build\
market-aware login experiences in headless storefronts.

Liquid storefronts handle this automatically with `{{ routes.account_login_url }}`, but headless storefronts previously had no documented way to construct login URLs that respect market context. We've added documentation and support for two optional\
authorization parameters:

* **[`locale`](https://shopify.dev/docs/api/customer#authorization)**: Controls the language of the login screen. Supports regional variants like `fr-CA` and `en-GB`, which load market-specific translations set through Translate & Adapt.
* **[`region_country`](https://shopify.dev/docs/api/customer#authorization)**: Controls the market context for policies, branding, and other non-translation content. Uses an ISO 3166-1 Alpha-2 country code.

These parameters can be used independently or together for a fully localized login experience.

Learn more about [building market-aware auth URLs for headless stores](https://shopify.dev/docs/storefronts/headless/building-with-the-customer-account-api/market-aware-auth-urls). For the full list of authorization parameters, refer to the [Customer Account API authorization reference](https://shopify.dev/docs/api/customer#authorization).