Customer data corrections
Request changes to customer profile fields through your Blaaiz Business Dashboard.
When to request a change
After a customer is verified, the API only lets you update profile fields that have no value. Use a change request when a saved customer detail needs correction.
You can request a change to any editable customer profile field. Examples include names, email, phone, date of birth (dob), ID type (id_type), ID number (id_number), country, and address fields. The available fields depend on the customer type.
You cannot use a change request to replace or edit an identity document, another customer file, or an owner's details. The supporting document attached to a request is evidence for the requested change. It does not replace a document on the customer record.
Submit a change request
Open the customer record in your Blaaiz Business Dashboard. Select Change Requests. Enter the fields and new values. Add a reason and a supporting document for every request.
The reason must contain 5 to 1,000 characters. The supporting document must be a PDF, JPG, JPEG, or PNG file up to 10 MiB. The document must support the change you requested.
The system saves the current customer values with the request and notifies compliance. An admin reviews the current values, requested values, reason, and evidence. The admin can approve the request, correct a requested value before approval, return the request for correction, or reject it.
Track the request
View the request and its status in the customer record in your Business Dashboard. The available statuses are:
| Status | Meaning |
|---|---|
PENDING | The request is waiting for review. |
RETURN | An admin needs you to correct the request. |
APPROVED | An admin approved the change. |
REJECTED | An admin rejected the request. This status is final. |
When an admin returns a request, update the request and submit it again with a new reason and supporting document. The system keeps the same request record, adds a submission attempt, changes the status to PENDING, and notifies compliance again.
You cannot edit or resubmit a REJECTED request. Submit a new request if you still need the change.
Set change_request_url in the Webhooks settings under API Services to receive updates. Blaaiz sends a signed webhook when an admin approves, returns, or rejects a request. The event names are business.customer.change_request.approved, business.customer.change_request.return, and business.customer.change_request.rejected.
Each webhook includes the request status, requested values, final approved values when applicable, and the admin's note.
Supporting document download links expire after 10 minutes. Open the request again to get a fresh link.
If you need to change a customer document
Change requests cover editable customer profile fields. They do not change identity documents, customer files, owner records, or KYB documents. Contact Blaaiz Support for help with those records.
For regular customer updates, see Update a customer. For business verification, see KYB onboarding.