Skip to main content

Instacart Connect APIs

Instacart Connect APIs are RESTful. They use predictable, resource-oriented URLs and HTTP response codes. The APIs use built-in HTTP features, such as HTTP authentication and HTTP verbs, which are understood by HTTP clients.

For help authenticating and making your first API call, see Get started.

Servers#

When you sign up for Instacart Connect, you are assigned two servers: one for development and one for production. You can verify the status of the servers on the status page. You need to sign in to view this page.

Authentication#

Before making API requests, authenticate with the Connect platform to generate an access token. You need your Instacart Connect client ID and client secret and your assigned server. For more information, see Authentication.

Secure requests#

All requests require HTTPS and an access token. When you make a request, use HTTPS with the domain of your Instacart server, and pass the generated access token as a Bearer token in the Authorization header. The following example request shows the syntax to use in cURL.

curl --request POST \  --url https://<Instacart_domain>/v2/fulfillment/users \  --header 'Accept: application/json' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{    "user_id": "string",    "first_name": "string"}'

If you use HTTP or omit the token, the request fails.

Supported languages#

You can make requests in any of the following languages:

  • cURL
  • Java
  • Python
  • Go

The endpoint topics include sample requests in each language. If you need another language, discuss your needs with an Instacart Connect representative.

Backward compatibility#

As the Instacart Connect product evolves and improves, we may make changes to the APIs to take advantage of new functionality and improvements. All changes made to APIs will maintain backward compatibility. Any new fields are optional and can be ignored if you want the APIs to continue to function as is.

Deprecation policy#

From time to time, the Instacart Connect team will deprecate fields, endpoints, services, or other items. We will announce the deprecation in the changelog and mark the item in the documentation. Deprecated items remain supported for a minimum of six months but might be removed in the future.