---
title: "INE webhook | Veriff.com"
slug: "ine-webhook"
description: "Learn how to set up the INE webhook in the Veriff Customer Portal for efficient registry checks and data management after verification sessions in Mexico."
tags: ["Mexican registries", "Registries", "INE"]
updated: 2025-11-14T11:20:58Z
published: 2025-11-14T11:20:58Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.veriff.com/llms.txt
> Use this file to discover all available pages before exploring further.

# INE webhook

> [!WARNING]
> This webhook is part of the [**legacy** INE verification solution](/v1/docs/ine-institutio-nacional-electoral-database-verification-guide). If you are interested in INE Database Verification solution, see the documentation of the [recent solution](/v1/docs/ine-database-verification).

The INE webhook passes back data after the check in the [**Mexican Electoral Registry (Instituto National Electoral)**](/v1/docs/ine-institutio-nacional-electoral-database-verification-guide) has been completed. The payload is sent to `Webhook INE registry URL`, which you need to set up in the Veriff Customer Portal.

→*See Webhooks Guide > [Set up webhooks](https://veriff-dev-documentation.document360.io/docs/webhooks-guide#set-up-webhooks) sub-section for detailed overview of the setup process*

---

## When is INE webhook sent?

The INE webhook is sent after the verification session is done and after the registry checks have been completed.

---

## Prerequisites

1. Make sure you **have access to the Veriff Customer Portal**
  1. If you do not, see the Getting Started → [Sign up](https://devdocs.veriff.com/docs/signing-up) and [Log in](https://devdocs.veriff.com/docs/logging-in) articles
2. Set up webhook URL(s) **on your side**and have them at hand
  1. Make sure they **match** the [Webhook URL](https://devdocs.veriff.com/docs/webhooks-guide#webhook-url-requirements) requirements
  2. Make sure your system is **able to handle** [Webhooks receipt, delivery and resending](https://devdocs.veriff.com/docs/webhooks-guide#webhook-delivery-receipt-and-resending) requirements
  3. Check the [Webhooks headers and payload](https://devdocs.veriff.com/docs/webhooks-guide#webhooks-headers-and-payload) section for info
3. Secure your communication, check the [HMAC Authentication and Endpoint Security](https://devdocs.veriff.com/docs/hmac-authentication-and-endpoint-security) article
4. Make sure your system is **able to handle** the [Backwards compatible changes](https://devdocs.veriff.com/docs/backwards-compatible-changes)

1. Proceed to [INE webhook setup below](/v1/docs/ine-webhook#ine-webhook-setup)

---

## INE webhook setup

1. Log in to the **Veriff Customer Portal**
2. Navigate to the **Integrations** page via the top menu and open the relevant integration used for the registry check
3. On the integration's page, select the **Settings** tab
4. Under the title **Integration settings** you see a list of webhooks
5. Fill in the `Webhook INE registry URL`

→*See Webhooks Guide > [Set up webhooks](https://veriff-dev-documentation.document360.io/docs/webhooks-guide#set-up-webhooks) sub-section for detailed overview of the setup process*

---

## Sample request

```json
{
  "eventType": "ine_registry",
  "sessionId": "f04bdb47-d3be-4b28-b028-a652feb060b5",
  "attemptId": "e30122d1-740b-4764-853f-470374a7abf4",
  "vendorData": "1234567812345678",
  "endUserId": "a1b2c35d-e8f7-6d5e-3cd2-a1b2c35db3d4",
  "version": "1.0.0",
  "time": "2021-06-02T11:04:00.287Z",
  "data": {
      "status": "La credencial es válida",
      "code": 200,
      "details": {
         "active": true,
         "documentState": "El documento es válido."
      }
  }
}
```

---

## Request properties explained

*Required field

- `eventType`: `string`* INE registry event name, returns: `ine_registry`
- `sessionId`: `string`* UUID for the session where this check was executed
- `attemptId`: `string`* UUID v4 which identifies session attempt
- `vendorData`: `string | null`* The unique identifier that you created for your end-user. `null` if not specified
- `endUserId`: `string | null`* The `UUID` that you created for your end-user. `null` if not specified
- `version`: `string`* Version number of the check
- `time`: `string`* Timestamp of sending the webhook, represented as` UTC YYYY-MM-DDTHH:MM:S+Timezone Offset `(ISO 8601)
- `data`: `object`* Array of data objects
  - `status`: `string` Status of the data
  - `code`: `number` An integer number of the HTTP status code. See the [Common HTTP status codes table](/v1/docs/common-http-status-codes) for more info
  - `details`: `object` Details connected to the specific check against the registry
    - `active`: `boolean` Indication of if the INE identification number is active (`true`) or inactive (`false`)
    - `documentState`: `string` Explanation of the `data.status` value

---

## Changelog

| Date | Description |
| --- | --- |
| Nov 14, 2025 | Legacy solution note added |
| Mar 12, 2025 | Documentation published |

## Related

- [INE (Institutio Nacional Electoral) database verification guide](/ine-institutio-nacional-electoral-database-verification-guide.md)
- [Webhooks Guide](/webhooks-guide.md)