Nuvemshop Connector for AI agents.

Yes, you can use it to list products, check stock levels, and update prices. It gives you a way to manage your catalog without leaving your AI client.

Just tell your agent the code name, the discount type, and any date requirements. It will create the coupon in your store automatically.

Yes, you can browse your customer database and get specific details for any user. It makes finding contact info or purchase history much faster.

You can list all orders and filter them by status to see your pending revenue. It's a great way to get a quick pulse on your daily sales.

Yes, you can create and manage webhooks for real-time notifications. This helps you connect your store to other apps for automated workflows.

It's simple. You just need your Store ID and an Access Token from your store settings. Once connected, your agent can start managing your store immediately.

Go to the Nuvemshop Developer Portal, create an application, and follow the OAuth 2.0 Authorization Code flow to generate your access token. The token format is AT-{store_id}-{hash}. Your Store ID is the numeric part of the token or can be found in your store URL/dashboard settings. Use both the access token and store ID to authenticate API requests.

Nuvemshop uses a Leaky Bucket algorithm with a default limit of 2 requests/second and a burst maximum of 40. Next and Evolution plans have this limit multiplied by 10. Monitor the x-rate-limit-remaining header in responses. If you hit the limit, the API returns HTTP 429. To avoid this, implement request queuing and respect the rate limit headers in your integrations.

Yes! Use the create_order capability with customer information and order items. This is perfect for phone orders, in-person sales, bulk order imports, or orders from other sales channels. You need to provide at minimum the customer email and at least one item with product ID and quantity. The order will appear in your Nuvemshop dashboard as a manual order.

Use list_variants with a product_id to see all variants for a product. Each variant has its own SKU, price, and stock quantity. Variants are created when you set up product options (like size or color) in the product creation or update process. The API handles variants as part of the product object, and you can manage inventory for each variant individually.