---
updatedAt: 2026-06-18T18:55:55.000Z
agentTools:
  projectIndex: https://docs.checkhq.com/llms.txt
---

# The notification object

A notification is an event that should be communicated to a user. Check has a Notifications API to capture events that should be communicated to an end user. Partners may build product experiences using the Notifications API, such as push notifications or in-product banners.

Check will offer direct [communications](https://docs.checkhq.com/reference/the-communication-object) to users for all notification topics. However, some partners will prefer to send communications themselves.

```json Sample notification object
{
  "id": "ntf_MrFrw0F82NSJjyw10Erk",
  "topic": "ready_for_payroll",
  "company": "com_zH8Gq33iBkFj5o0GKjTw",
  "recipient_type": "company",
  "recipient": "com_zH8Gq33iBkFj5o0GKjTw",
  "email_communication": null,
  "created_at": "2024-01-19 17:04:15+00"
}
```
```json Sample notification object with communication
{
  "id": "ntf_MrFrw0F82NSJjyw10Erk",
  "topic": "ready_for_payroll",
  "company": "com_zH8Gq33iBkFj5o0GKjTw",
  "recipient_type": "company",
  "recipient": "com_zH8Gq33iBkFj5o0GKjTw",
  "email_communication": "cmn_MrFrw0F82NSJjyw10Erk",
  "created_at": "2024-01-19 17:04:15+00"
}
```

<br />

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `id`  
        _string_
      </td>

      <td>
        Unique identifier of the notification.
      </td>
    </tr>

    <tr>
      <td>
        `topic`  
        _string_
      </td>

      <td>
        [Topic](https://docs.checkhq.com/reference/notification-topics) of the notification.
      </td>
    </tr>

    <tr>
      <td>
        `company`  
        _string_
      </td>

      <td>
        ID of the company associated with the intended recipient of the notification.
      </td>
    </tr>

    <tr>
      <td>
        `recipient_type`  
        _enum_
      </td>

      <td>
        Type of notification recipient. Can be `company`. 
      </td>
    </tr>

    <tr>
      <td>
        `recipient`  
        _string_
      </td>

      <td>
        ID of the intended recipient of the notification.
      </td>
    </tr>

    <tr>
      <td>
        `email_communication`  
        _string_
      </td>

      <td>
        ID of the associated [email communication](https://docs.checkhq.com/reference/the-communication-object) created by Check.
      </td>
    </tr>

    <tr>
      <td>
        `created_at`  
        _string_
      </td>

      <td>
        The time when the notification was created.
      </td>
    </tr>
  </tbody>
</Table>