LogoLogo
Contact API support
  • Build apps
  • Site Templates
  • REST API Reference
  • Storefronts (JS API)
  • Webhook automations
  • Discounts
  • Guides
  • Changelog
  • Build with Ecwid apps
  • Ecwid API features
  • Get started
    • Set up your dev environment in Ecwid
    • Make your first API request
    • Add more features to your custom app
    • API glossary
  • Develop apps
    • What is an Ecwid app
    • Private and public Ecwid apps
    • App settings
    • Community libraries
  • Launch apps
    • Public apps overview
    • FAQ about public applications
    • Monetize public apps
    • Steps to go live with a public app
    • Native and external apps
      • Access store data from the app
      • Build user settings page for Ecwid admin
        • Use Native app JS SDK
        • Deep linking
        • Manage personal user settings storage
  • Contact Ecwid API support team

Lightspeed® 2025

On this page
  • Before you begin
  • Step 1. Get your secret app token
  • Step 2. Make your first REST API request
  • Next steps

Was this helpful?

  1. Get started

Make your first API request

PreviousSet up your dev environment in EcwidNextAdd more features to your custom app

Last updated 28 days ago

Was this helpful?

All requests to Ecwid REST API require an access token. Ecwid uses OAuth 2.0 to provide secure access to the store data for public apps. If you customize your own store, however, you can skip OAuth and easily get an access token for your store.

This guide provides a walkthrough of a basic Ecwid API interaction, specifically, retrieving store profile information. To gain a deeper understanding of Ecwid API objects and their connections, refer to the API reference.

Before you begin

There is no test mode in Ecwid API, so we recommend setting up a separate test store. This way you can safely experiment and develop without impacting your live store and its data. By isolating your testing activities, you can maintain a smooth experience for both development and production environments.

Step 1. Get your secret app token

API access to the store data is locked behind app authentication and request authorization based on the OAuth 2.0 standard. However, access to your store data is much simpler.

After signing up with Ecwid and getting a custom app, you already have two tokens:

  • Public token allows only public data to be received and is safe to use in public code.

  • Secret token grants full access to REST API (provided the app has all required permissions) and therefore must be kept safe.

Learn more about tokens, permissions, and other application settings in the App settings guide.

From the , open the Details page of the custom app, then copy one of the access tokens:

If the custom app is uninstalled from the store, you can reinstall it from the Details page. Click the Install button, then copy access tokens.

Step 2. Make your first REST API request

Now you have everything to start making REST API requests. Let's start with a simple GET request. Such requests require only two variables: store ID and access token.

You already have a custom app with access tokens. Get your store ID from any Ecwid admin page from URL or the footer.

Add store ID to the request path, your secret access token as a Bearer Token on the Authorization tab, and click Send:

That’s it. You should receive a JSON-formatted response with details about products in your store.

Next steps

Congratulations on completing the quickstart guide!

Now you can make REST API requests, so it’s time to move further:

Now make a simple “Get products” request and execute it using, for example, the .

Postman app
Learn Ecwid API features
Learn more about app settings: access tokens, scopes, etc.
Add more features to your custom app
app dashboard