Create an Instacart user

POST /v2/fulfillment_sandbox/instacart_users

Creates an Instacart user.

Security

Name	In	Description
Authorization	header	The Authorization header with the bearer token acquired during authentication.

Parameters

None.

Request

Field	Type	Required	Description
email	string		The email of the Instacart User.
phone	string		The phone number of the Instacart User. Must be in E.164 format. Example: +14155552671.
password	string		The password of the Instacart User.
express_member	boolean		Deprecated. Use 'instacartplus_member' instead. Defaults to false.
instacartplus_member	boolean		Indicates whether the Instacart User is an Instacart+ member. Defaults to false.

Request examples

cURL

curl --request POST \
  --url https://connect.instacart.com/v2/fulfillment_sandbox/instacart_users \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "string",
  "phone": "string",
  "password": "string",
  "express_member": true,
  "instacartplus_member": true
}'

Java

HttpResponse<String> response = Unirest.post("https://connect.instacart.com/v2/fulfillment_sandbox/instacart_users")
  .header("Accept", "application/json")
  .header("Content-Type", "application/json")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"email\": \"string\",\n  \"phone\": \"string\",\n  \"password\": \"string\",\n  \"express_member\": true,\n  \"instacartplus_member\": true\n}")
  .asString();

Python

import http.client

conn = http.client.HTTPSConnection("connect.instacart.com")

payload = "{\n  \"email\": \"string\",\n  \"phone\": \"string\",\n  \"password\": \"string\",\n  \"express_member\": true,\n  \"instacartplus_member\": true\n}"

headers = {
    'Accept': "application/json",
    'Content-Type': "application/json",
    'Authorization': "Bearer <token>"
}

conn.request("POST", "/v2/fulfillment_sandbox/instacart_users", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Go

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://connect.instacart.com/v2/fulfillment_sandbox/instacart_users"

	payload := strings.NewReader("{\n  \"email\": \"string\",\n  \"phone\": \"string\",\n  \"password\": \"string\",\n  \"express_member\": true,\n  \"instacartplus_member\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Accept", "application/json")
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Node.js

const http = require('https');

const options = {
  method: 'POST',
  hostname: 'connect.instacart.com',
  port: null,
  path: '/v2/fulfillment_sandbox/instacart_users',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Authorization: 'Bearer <token>'
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on('data', function (chunk) {
    chunks.push(chunk);
  });

  res.on('end', function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({
  email: 'string',
  phone: 'string',
  password: 'string',
  express_member: true,
  instacartplus_member: true
}));
req.end();

Response

Field	Type	Required	Description
id	integer		The ID of the Instacart user.

Response examples

Success

200 Instacart User created

{
  "id": 1
}

4XX Errors

Error responses return either a single error or multiple errors.

HTTP Code	Cause	Error Message	Error Code	Error Meta
400	Account already exists	"An account already exists with this email"	1001	{"key":"email"}