Get started
Learn the basics of building an Instacart Connect API integration. At any time, if you have questions or run into problems, you can contact Instacart Enterprise Technical Support.
This overview assumes that you’ve already shared your catalog and enabled the Developer Dashboard.
1. Get your credentials
During onboarding, Instacart creates separate OAuth applications for your development and production environments. We then securely provide you each application’s credentials, which consist of a client ID and secret.
To manage your credentials, you can use our OAuth applications tool.2. Get a bearer token
Accessing Connect API resources requires a valid bearer token. To get one, make a request to your Connect OAuth application’s generate token endpoint. In the request, include your client credentials, along with the appropriate permissions and scopes.
3. Make an API request
When configuring a Connect API request, include the bearer token in its authorization header. In the API reference section, you’ll find path, security, parameter, request, and response specifications for each available endpoint.
4. Configure webhooks
To help build your fulfillment workflows, you can use our webhooks configuration tool. After they're created, these webhooks enable you to receive event notifications in both your development and production environments.*
5. Start building
Once you’re ready to start building, you can follow one of our Connect API guides. In them, you’ll find how-to-articles and step-by-step tutorials, along with information on key concepts.
6. Test your integration
As you develop, Instacart’s Fulfillment Testing Center and Sandbox APIs allow you to evaluate your integration.
* If you have unique callback requirements, such as custom headers, that can’t be configured in the webhooks self-service tool, contact your Instacart technical support team. While we work with you to devise a solution, you can move on to the start building step.