Grid card events

Grid card events notify you when grid cards are created or when related email notifications are sent. When a grid card event is triggered, IDaaS sends an HTTP POST request to your configured webhook URL with a JSON payload containing the event details.

Payload structure

Every grid card event payload has this structure:

{
  "id": "019cf7c8-2a57-769a-a8dc-7dd6adfd23d3",
  "type": "grid.created",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T17:53:36Z",
  "data": {
    // Event-specific data here
  }
}

The data object contains event-specific fields. See the event examples later on this page for the full data object for each event type.

Top-level fields

Field	Type	Description
id	string	Unique identifier for this webhook delivery
type	string	The event that occurred (e.g., grid.created)
accountId	string	Your account identifier
eventTime	string	When the event occurred (ISO 8601 format)
data	object	Details about what happened (varies by event type)

Event types

grid.created

Triggered when a grid card is created.

Example payload:

{
  "id": "019cf7c8-2a57-769a-a8dc-7dd6adfd23d3",
  "type": "grid.created",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T17:53:36Z",
  "data": {
    "subject": "7a578db7-e8c8-421c-b5aa-2975f1418932",
    "subjectName": "john",
    "subjectType": "USER",
    "resourceName": "User Portal",
    "sourceIp": "104.30.161.19",
    "entityType": "GRIDS",
    "entityId": "722c9dce-6c0c-49db-bfad-4ba5a6d698f9",
    "entityName": "2",
    "entityAttributes": {
      "serialNumber": 2,
      "expired": false,
      "state": "PENDING",
      "type": "GRID_CARD",
      "userId": "john",
      "createDate": "2026-03-16T17:53:36Z"
    }
  }
}

The data object includes the following fields:

Field	Description
subject	ID of the user for whom the grid card was created
subjectName	Username of the user for whom the grid card was created
subjectType	Always USER
resourceName	Where the grid card was created (e.g., "User Portal")
sourceIp	IP address from which the grid card was created
entityType	Always GRIDS for grid card events
entityId	ID of the grid card
entityName	Grid card identifier or serial number as a string
entityAttributes	Details about the created grid card (see below)

The entityAttributes object includes these fields:

• serialNumber - Grid card serial number
• expired - Whether the grid card is expired
• state - Current grid card state
• type - Always GRID_CARD
• userId - Username associated with the grid card
• createDate - Date and time when the grid card was created

grid.email.sent

Triggered when a grid card email is sent.

Example payload:

{
  "id": "019cf7c8-2ea1-7f18-bd6d-cae662c4ce96",
  "type": "grid.email.sent",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T17:53:37Z",
  "data": {
    "subject": "7a578db7-e8c8-421c-b5aa-2975f1418932",
    "subjectName": "john",
    "subjectType": "USER",
    "resourceName": "Administration Portal",
    "sourceIp": "104.30.161.19",
    "entityType": "GRIDS",
    "entityId": "722c9dce-6c0c-49db-bfad-4ba5a6d698f9",
    "entityName": "2",
    "entityAttributes": {
      "contactValue": "john.smith@example.com",
      "contactType": "Email"
    }
  }
}

The data object includes the following fields:

Field	Description
subject	ID of the user associated with the emailed grid card
subjectName	Username of the user associated with the emailed grid card
subjectType	Always USER
resourceName	Where the email was sent from (e.g., "Administration Portal")
sourceIp	IP address from which the email was sent
entityType	Always GRIDS for grid card events
entityId	ID of the grid card
entityName	Grid card identifier or serial number as a string
entityAttributes	Delivery details for the emailed grid card (see below)

The entityAttributes object includes these fields:

• contactValue - Email address that received the grid card message
• contactType - Contact method used for the delivery

grid.password.email.sent

Triggered when a grid card password email is sent.

Example payload:

{
  "id": "019cf7c8-2ea3-75e2-8044-f74c5187c403",
  "type": "grid.password.email.sent",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T17:53:37Z",
  "data": {
    "subject": "7a578db7-e8c8-421c-b5aa-2975f1418932",
    "subjectName": "john",
    "subjectType": "USER",
    "resourceName": "Administration Portal",
    "sourceIp": "104.30.161.19",
    "entityType": "GRIDS",
    "entityId": "722c9dce-6c0c-49db-bfad-4ba5a6d698f9",
    "entityName": "2",
    "entityAttributes": {
      "contactValue": "john.smith@example.com",
      "contactType": "Email"
    }
  }
}

This event uses the same data structure as grid.email.sent.

Field	Description
subject	ID of the user associated with the emailed grid card password
subjectName	Username of the user associated with the emailed grid card password
subjectType	Always USER
resourceName	Where the email was sent from (e.g., "Administration Portal")
sourceIp	IP address from which the email was sent
entityType	Always GRIDS for grid card events
entityId	ID of the grid card
entityName	Grid card identifier or serial number as a string
entityAttributes	Delivery details for the emailed grid card password (see below)