Skip to main content

Create a Connect user account

POST /v2/fulfillment/users

Creates a Connect user account with the user ID specified in the body of the request. The user ID is defined by your site and can be any unique identifier, such as a login name, loyalty ID, or email address.

Instacart uses the user ID to link together multiple API requests. For example, when you reserve a time slot or create an order, you specify the user ID in the request path. You might also need the user ID when troubleshooting issues.

The Connect user account is separate from the retailer customer account and the customer's Instacart account. You can, however, choose to store the Connect user IDs with your other customer account information and reuse them. You can also choose to implement Account linking and invite customers to link their Instacart account.

Security#

NameInDescription
AuthorizationheaderThe Authorization header with the bearer token acquired during authentication.

Request#

FieldTypeRequiredDescription
user_idstringโœ…Unique user ID to use for this user.
first_namestringโœ…The user's first name. Note this field does not support special characters /:<>$%?.
last_namestringThe user's last name. Note this field does not support special characters /:<>$%?.
phone_numberstringThe user's phone number.
localestringThe user's locale in IETF Language Tag format. Example: en-US.

Request Examples#

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

Response#

FieldTypeRequiredDescription
user_idstringโœ…The ID of the user.
first_namestringโœ…The user's first name.
last_namestringThe user's last name.
phone_numberstringThe user's phone number.
localestringThe user's locale in POSIX format. Example: en_US.

Response Examples#

{  "user_id": "roberteospeedwagon",  "first_name": "Robert",  "last_name": "Speedwagon",  "phone_number": "5555555555",  "locale": "en_CA"}