Skip to main content
Some Lucca API endpoints are still in beta and may not be feature-complete. They are marked with a “BETA” badge in the API Reference.Like all previous legacy API endpoints, beta endpoints are susceptible to breaking changes.Once out of beta, endpoints are considered stable and subject to our deprecation policy. Check the lifecycle recap for the up-to-date status of each endpoint.
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.