Customers - Natural Docs

All error responses follow the standard error format. Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.

Code	Status	Detail
`customer_invitation_recipient_unsupported_in_sandbox`	400	Email and phone recipients aren’t supported in Sandbox. Use POST /simulations/invite-customer.
`invalid_pagination_cursor`	400	The page cursor is not valid. Start the list again.
`invalid_value`	400	The information you entered isn’t valid. Please check it and try again.
`unauthenticated`	401	Authentication is required.
`forbidden`	403	You do not have permission to perform this action.
`customer_not_found`	404	Customer not found.
`already_exists`	409	The resource already exists.
`conflict`	409	The request conflicts with the current resource state.
`rate_limited`	429	Too many requests. Please try again later.
`server_error`	500	Something went wrong.
`bad_gateway`	502	We couldn’t complete that request because one of Natural’s services returned an unexpected response. Please try again.
`bad_gateway`	502	Natural could not complete the request because one of its services returned an unexpected response. Try again.
`service_unavailable`	503	The service is temporarily unavailable.