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
| Name | Type | Required | Description |
|---|---|---|---|
address1 | string | Optional | Primary street address line |
address2 | string | Optional | Optional secondary address line (apartment, suite, etc.) |
city | string | Optional | City name |
country | string | Optional | Country code (ISO format) |
firstName | string | Optional | First name of the customer |
lastName | string | Optional | Last name of the customer |
phone | string | Optional | Phone number of the customer |
state | string | Optional | State or province code |
zip | string | Optional | Postal or ZIP code |
Response Data
Fields returned in the response
| Name | Type | Required | Description |
|---|---|---|---|
address1 | string | Optional | Primary street address line |
address2 | string | Optional | Optional secondary address line (apartment, suite, etc.) |
city | string | Optional | City name |
country | string | Optional | Country code (ISO format) |
createdAt | string (date-time) | Required | Timestamp when the customer record was created |
creditIpAddress | string | Optional | IP address used when performing the credit check |
creditStatus | Required | Current credit check status (unknown, passed, or failed) | |
creditTimestamp | string | Optional | Timestamp when the credit check was performed |
id | CustomerPubId | Required | Public-facing unique identifier for the customer |
phone | string | Optional | Phone number of the customer |
state | string | Optional | State or province code |
stripeId | string | Optional | Stripe customer ID for payment processing (production) |
stripeSandboxId | string | Optional | Stripe customer ID for payment processing (sandbox) |
updatedAt | string (date-time) | Required | Timestamp when the customer record was last updated |
userId | UserId | Required | User account associated with this customer |
zip | string | Optional | 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": "2025-12-10T18:00:54.111Z",
"creditStatus": null,
"id": null,
"updatedAt": "2025-12-10T18:00:54.111Z",
"userId": "string"
}