Updates customer profile details including name and addre...

PUT/v1/customers/{id}

Updates customer profile details including name and address information. Use this endpoint when organization admins need to update customer information. All fields are optional - only provided fields will be updated. Requires CustomerWrite permission on the target customer.

Parameters

Request parameters for this endpoint

Name	Location	Type	Required	Description
id	path	string	Required	Customer ID to update

Request Body

Fields in the request body

Optional

Name	Type	Description
address1	string	Primary street address line
address2	string	Optional secondary address line (apartment, suite, etc.)
city	string	City name
country	string	Country code (ISO format)
firstName	string	First name of the customer
lastName	string	Last name of the customer
phone	string	Phone number of the customer
state	string	State or province code
zip	string	Postal or ZIP code

Response Data

Fields returned in the response

Always Present

Name	Type	Description
createdAt	string (date-time)	Timestamp when the customer record was created
creditStatus		Current credit check status (unknown, passed, or failed)
id	CustomerPubId	Public-facing unique identifier for the customer
identityVerificationStatus		Identity verification status (none, pending, processing, verified, failed)
updatedAt	string (date-time)	Timestamp when the customer record was last updated
userId	UserId	User account associated with this customer

Optional

Name	Type	Description
address1	string	Primary street address line
address2	string	Optional secondary address line (apartment, suite, etc.)
city	string	City name
country	string	Country code (ISO format)
creditIpAddress	string	IP address used when performing the credit check
creditTimestamp	string	Timestamp when the credit check was performed
phone	string	Phone number of the customer
state	string	State or province code
stripeId	string	Stripe customer ID for payment processing (production)
stripeSandboxId	string	Stripe customer ID for payment processing (sandbox)
stripeVerificationSessionId	string	Stripe Identity verification session ID
zip	string	Postal or ZIP code

PUT/v1/customers/{id}

Request

curl https://api.thesweetspot.com/v1/customers/id_123 \
  -X PUT \
  -H "Content-Type: application/json" \
  -d '{
  "address1": null,
  "address2": null,
  "city": null,
  "country": null,
  "firstName": null,
  "lastName": null,
  "phone": null,
  "state": null,
  "zip": null
}'

Response

{
  "createdAt": "2026-02-04T02:25:19.538Z",
  "creditStatus": null,
  "id": null,
  "identityVerificationStatus": null,
  "updatedAt": "2026-02-04T02:25:19.538Z",
  "userId": "string"
}