Identification

Identification is the foundational step for integrating your app with Mantle. This process establishes a secure connection between your app and Mantle's platform, enabling analytics, billing capabilities, and customer insights.

Why identification matters

Identifying your customers to Mantle allows the platform to:

• Create a unified record of each customer's activity and data
• Provide secure access to Mantle's APIs through customer-specific tokens
• Enable advanced analytics and reporting capabilities
• Support billing operations when needed

Identification as your data gateway

The /identify endpoint is the only endpoint that directly updates customer information in Mantle's App API. It serves two critical functions:

1. Enriching data automatically - When provided with an access token, Mantle automatically pulls this information:

   • Shop plan
   • Email address on file
   • Trial information
   • Discount information

2. Accepting custom data directly - You can manually send, fill in, or update these additional details:

   • Updated email addresses
   • Customer tags
   • Custom fields
   • Country/location data
   • Contact details (name, email, phone)
   • Any other merchant-specific attributes

This endpoint gives you precise control over what information is stored in your customer profiles, whether through automatic enrichment or manual updates.

Identification methods

Mantle offers two approaches to customer identification, each designed for specific use cases:

Basic identification

A streamlined approach that provides analytics capabilities without requiring a Shopify access token. Ideal for apps focused on customer insights and tracking without billing requirements.

Enhanced identification

A comprehensive method that leverages the Shopify access token to enable the full spectrum of Mantle capabilities, including subscription management and billing operations.

Using identification with a proxy

For enhanced security or infrastructure requirements, Mantle supports proxying your identification requests. This allows you to route identify calls through your own services before they reach Mantle.

See our API Proxy for details on implementing this approach.

Choosing the right method

Select your identification method based on your app's requirements:

• For analytics only: Use Basic Identification to track customer activity and gain insights without implementing billing functionality.
• For analytics + billing: Use Complete Identification to access all Mantle features, including subscription management and usage-based billing.
• For enhanced security: Consider using the API Proxy approach alongside either identification method.

All methods return a unique customer API token that you'll use for subsequent requests to Mantle's API, ensuring secure communication while protecting sensitive information.