Request Update (KYB)

Send data correction requests to clients during business verification using the iDenfy KYB request update feature with webhook alerts.

The Request Update solution simplifies the process of correcting client data, ensuring your records are current and compliant.

---

Request Update

To send a request for additional information to a client:

1. Go to the Dashboard → Business Verifications → Verifications.
2. Select the company name you wish to update → Request Information.
3. Select the fields you want the client to revise and add the recipient’s email address. A note is mandatory for the Director, Representative, and Shareholder sections; the company information note and the questionnaire note are optional. Every note is capped at 512 characters.
4. Click Request Update.

Request update is unavailable while a company is already in Under submission — an existing request must be submitted, cancelled, or expired first. The feature is also plan-gated: accounts without it see “Request update feature is not supported with your plan.”

Sections are opt-in on both sides. In the dashboard, each section toggle must be switched on individually unless Allow to edit all is used. For the client, every requested section must be opened and worked through before Submit unlocks — until then the form shows “Please edit required sections to continue.”

---

Configuring the Update Request

You can select to allow editing for the entire verification form, or select specific categories:

Editable Category	Selection Options	Additional Information
Allow to edit all	A single switch that grants the client access to all business verification fields.	Use if the verification is largely outdated.
Request company information modifications	Select specific Fields, custom fields, and Documents to be updated (e.g., Company name, Registration number, Certificate of Incorporation). Each selected item is Optional by default — marking it Required means the client must actually change that value before submitting.	The Relevant to client request notes are optional here (max 512 characters), for example “Please edit your company name and upload the updated Certificate.”
Allow to edit Director information	Allow editing of the whole Director page. You cannot select individual fields, as there may be multiple Directors.	A note is mandatory for this section (max 512 characters), for example “Please update John’s email address.”
Allow to edit Representative information	Allow editing of the whole Representative page.	A note is mandatory for this section (max 512 characters).
Allow to edit Shareholders’ information	Allow editing of the whole Shareholder page.	A note is mandatory for this section (max 512 characters). The Shareholders note is shared with the UBO and ABO sections.
Add additional questionnaire or questions	Select one of three ways: 1. Request the client to update an existing questionnaire. 2. Ask them to answer a new single question. 3. Add a completely new questionnaire for them to complete.	The note is optional (max 512 characters) and can be used to guide the client on the new questions/forms.
Request validity duration (days)	Sets how long the unique link will remain active.	Defaults to 30 days, which is also the maximum.
Follow-up reminder	Sends a reminder email if the client hasn’t submitted the form.	No reminder is sent by default. The option is only selectable when the validity duration is longer than 1 day, and the reminder date must fall before the link expires. The reminder is the original email re-sent as a reply, with the subject prefixed Re:.
Email Address	The recipient’s email.	Required. Ensure the proper client’s email is prefilled.
Select email template	Select a pre-made email text.	Optional — picking a template prefills the subject and message body, which stay editable.
Email subject	Write a clear subject line.	Always mandatory, whether or not a template is selected.
Add recipients to CC	Add colleagues or other relevant parties to the notification email.	Optional.
Message to client	The main body of the email.	Required. Enter clear and informative content.
Add revision request link	Inserts the link tag {{session_url}} into the message.	Strongly recommended — the request can be sent without it, but the client’s email then contains no link to the form, leaving them no way to open it.

---

Managing an Active Request

• Sending a new request immediately invalidates the previous link.
• Cancel request update returns the company to its review or processing state.
• When the link expires without a submission, the company reverts to the status it held before the request — it is not left in Under submission — and a webhook fires with status: EXPIRED.
• An expired request can be extended by setting a new validity duration and sending a new email.

---

Status

The company application has been submitted and is awaiting further action or review.

The application is in “Under Submission” status while waiting for the client to complete the requested changes

If the client opens the link and submits the form without changing anything, the submission is still recorded: a Submitted KYB form data without any changes entry is written to the audit log, so a review-and-resubmit is traceable rather than leaving no trace at all. The entry is only written when a submission answers an update request — if the request expires without a submission, nothing is logged.

The company is marked Completed, meaning the review finished as either Approved or Denied.

---

Webhooks for Request Update

For automated notifications regarding status changes and client submissions, you can configure KYB webhooks. This allows your system to listen for update events in real-time.

The whole request lifecycle is covered by a single event, COMPANY INFO REQUEST (companyInfoRequest), which carries companyId, token, date, email, manager, and a status of:

status	Meaning
REQUESTED	The update request was sent to the client
EXPIRED	The link expired without a submission
CANCELED	The request was cancelled in the dashboard

The client’s submission does not fire this event — it fires the separate COMPANY SUBMIT (companySubmit) event.

/KYB/kybWebhook#webhook-events-for-companies