---
updatedAt: 2025-06-12T23:58:47.000Z
agentTools:
  projectIndex: https://docs.fiatrepublic.com/llms.txt
---

# The Webhook Object

We use webhooks to notify your application when an event happens on an object. Most workflows on Fiat Republic are asynchronous and therefore it is extremely useful for you to use appropriate webhooks in your integration (e.g. when a Fiat Account is activated or receives a Payment).

Webhooks can be created and managed via the Developers section on the Dashboard. If you prefer to create them programmatically, you can do so via the Webhooks API.

| 📘 **NOTE:** Webhook events will be retried 10 times, with a new attempt occurring every 10 minutes. |
| :--------------------------------------------------------------------------------------------------- |

### Webhook Object

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

      <th>
        Description
      </th>

      <th>
        Format/Enum
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **id**
        *string*
      </td>

      <td>
        Unique identifier of the webhook.
      </td>

      <td>
        e.g. `whk_ejl2vpn1m305rxko6b`
      </td>
    </tr>

    <tr>
      <td>
        **url**\
        *string*
      </td>

      <td>
        URL configured to receive events.
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        **events**\
        *array of strings*
      </td>

      <td>
        Events to receive on the configured URL.
      </td>

      <td>
        See [Webhook Setup](https://docs.fiatrepublic.com/docs/webhooks) for a list of events and further details.
      </td>
    </tr>

    <tr>
      <td>
        **status**\
        *string*
      </td>

      <td>
        Status of the webhook.
      </td>

      <td>
        `ENABLED`, `DISABLED`
      </td>
    </tr>

    <tr>
      <td>
        **description**\
        *string*
      </td>

      <td>
        Optional description for the webhook.
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        **createdAt**\
        *integer*
      </td>

      <td>
        Epoch timestamp at which the object was created.
      </td>

      <td>
        e.g. `1637593856104`
      </td>
    </tr>

    <tr>
      <td>
        **updatedAt**\
        *integer*
      </td>

      <td>
        Epoch timestamp at which the object was last updated.
      </td>

      <td>
        e.g. `1637593856104`
      </td>
    </tr>

    <tr>
      <td>
        **metadata**\
        *string*
      </td>

      <td>
        Additional data in JSON `key:value` format.
      </td>

      <td>
        See [Metadata](https://docs.fiatrepublic.com/docs/metadata) for more information.
      </td>
    </tr>
  </tbody>
</Table>