Skip to main content
Some Lucca API endpoints are still in beta phase. Which means they are susceptible to breaking changes. API endpoints that are in beta are marked with a “BETA” warning in the API Reference, and should thus be considered susceptible to breaking changes.
Some endpoints may not be immediately available to you, as it requires opting in. In order to gain access to these features, please contact our support.
The Lucca API tries to conform to the constraints of the REST architectural style. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication schemes, and HTTP methods. To get started using the Lucca API:
1

Pick an environment

You can use the Lucca API either in a production, sandbox or demo environment. You should first test out your integration on a sandbox, then deploy it in production. Learn about environments.
2

Authenticate

Authentication is OAuth 2.0 based. Learn how to authenticate.
3

Send your HTTP requests following the API reference below.

You may want to browse our guides, as one might shed light on how to achieve what you’re trying to do.
Please, bear in mind:
  • The Lucca API doesn’t support bulk updates. You can only change the state of a single resource per request.
  • This API is versioned. Version is set through the Api-Version HTTP header.
  • Better many small requests than a few large ones. The Lucca API is rate and size limited.
  • If you plan to issue HTTP requests for multiple customer accounts: each one has its own API URL (subdomain) and access token.
  • All collection endpoints enforce pagination. Make sure your script is ready for this.