Link your own customer ID to Storefront
If you already track customers in your own system — a CRM, a billing platform, your own user database — you can tag each Storefront customer record with that same ID. This lets you match a Storefront customer back to your own records, in either direction, without having to guess based on name or email.
There are two ways to set this ID, depending on how the customer reaches Storefront.
Option 1: Set it when a customer arrives via a link
If you're sending customers to your Storefront from your own website or platform, add an extuserid query string parameter to the link:
https://yourstorefront.com?extuserid=your-internal-id-123
Storefront reads this parameter, stores it in the customer's session, and applies it to their customer record once they complete registration.
Option 2: Set it when creating a customer via the API
If you're creating customers programmatically — for example, during a migration or automated signup — include external_user_id in the request body:
{
"first_name": "Jane",
"last_name": "Doe",
"email": "[email protected]",
"username": "janedoe01",
"external_user_id": "your-internal-id-123",
...
}Where the ID shows up
Once set, the ID is visible on the customer's Customer Detail page in Storefront Manager, and is returned in the customer object whenever you fetch that customer via the API. It can also be added, changed, or removed manually from Storefront Manager at any time.
Not just for customer IDsDespite the name,
external_user_idcan hold any value you want — an internal customer ID, an account number, a campaign tag, whatever's useful for matching this record back to your own systems.
Where this is used
Linking your own ID to a Storefront customer is the foundation for several other integrations:
- Migrate an Existing Customer Base Into Storefront — set your existing customer IDs during bulk creation, so every migrated customer is already linked
- Notify Your CRM the Moment a Customer Registers — use the ID to match an incoming webhook event back to your own customer record
Related articles
Updated 6 days ago