# Webhook call

This represents a log entry in the webhooks activity list, detailing a specific webhook event along with its delivery attempt information.

## Object payload

**`id`**

- Type: string
- Example: `"42"`

ID of webhook call

**`type`**

- Type: string

Must be exactly `"webhook_call"`.

**`entity_type`**

- Type: enum
- Example: `"item"`

The subject of webhook triggering

<details>
<summary>Show enum values</summary>

**`item_type`**

**`item`**

**`upload`**

**`build_trigger`**

**`environment`**

**`maintenance_mode`**

**`sso_user`**

**`cda_cache_tags`**

</details>

**`event_type`**

- Type: enum
- Example: `"update"`

The event that triggers the webhook call

<details>
<summary>Show enum values</summary>

**`create`**

**`update`**

**`delete`**

**`publish`**

**`unpublish`**

**`promote`**

**`deploy_started`**

**`deploy_succeeded`**

**`deploy_failed`**

**`change`**

**`invalidate`**

</details>

**`created_at`**

- Type: date-time
- Example: `"2016-09-20T18:50:24.914Z"`

The moment the event was created

**`request_url`**

- Type: string
- Example: `"https://www.example.com/webhook"`

The url that the webhook called

**`request_headers`**

- Type: object

The request's headers

Example:

```json
{
  Accept: "*/*",
  "User-Agent": "DatoCMS (datocms.com)",
  Authorization: "Basic Y2lhbzptaWFv",
  "Content-Type": "application/json",
}
```

**`request_payload`**

- Type: string
- Example: `'{"webhook_call_id":"103216210","event_triggered_at":"2024-08-26T12:49:16Z","attempted_auto_retries_count":0,"webhook_id":"28374","site_id":"205","environment":"main","is_environment_primary":true,"entity_type":"maintenance_mode","event_type":"change","entity":{"id":"maintenance_mode","type":"maintenance_mode","attributes":{"active":false}},"related_entities":[]}'`

The webhook's request payload is encoded as a string. Use `JSON.parse()` to parse it.

**`response_status`**

- Type: integer, null
- Example: `200`

The status of the response

**`response_headers`**

- Type: object, null

The response's headers

Example:

```json
{
  via: "1.1 vegur, 1.1 37c0945d19329fccc23efb283d01aa06.cloudfront.net (CloudFront)",
  date: "Fri, 27 Jul 2018 11:59:20 GMT",
  server: "gunicorn/19.6.0",
}
```

**`response_payload`**

- Type: string, null
- Example: `"ok"`

The body of the response

**`attempted_auto_retries_count`**

- Type: integer
- Example: `2`

The number of retries attempted so far

**`last_sent_at`**

- Type: date-time
- Example: `"2016-09-20T18:50:24.914Z"`

The last moment the call occurred

**`next_retry_at`**

- Type: date-time, null
- Example: `"2016-09-20T18:50:24.914Z"`

The date when the next retry attempt is scheduled to run. If no retry attempt is scheduled, it is set to null

**`status`**

- Type: enum
- Example: `"success"`

The current status

<details>
<summary>Show enum values</summary>

**`pending`**

The delivery attempt is currently in process

**`success`**

Delivery completed successfully

**`failed`**

Delivery attempt(s) failed due to errors/timeouts

**`rescheduled`**

The last delivery attempt failed, a new one will be retried later

</details>

**`webhook`**

- Type: [ResourceLinkage\<"webhook"\>](https://www-draft.datocms.com/docs/content-management-api/resources/webhook.md)

The webhook which has been called

## Available endpoints

-   [List all webhooks calls](https://www.datocms.com/docs/content-management-api/resources/webhook-call/instances.md)
-   [Retrieve a webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call/self.md)
-   [Re-send the webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call/resend_webhook.md)

## Related content in "Content Management API"

- [Content Management API Overview](https://www.datocms.com/docs/content-management-api.md)
- [Using the JavaScript CMA client](https://www.datocms.com/docs/content-management-api/using-the-nodejs-clients.md)
- [API versioning](https://www.datocms.com/docs/content-management-api/api-versioning.md)
- [Authentication](https://www.datocms.com/docs/content-management-api/authentication.md)
- [Environments](https://www.datocms.com/docs/content-management-api/setting-the-environment.md)
- [Error codes & handling failures (CMA)](https://www.datocms.com/docs/content-management-api/errors.md)
- [Pagination](https://www.datocms.com/docs/content-management-api/pagination.md)
- [Asynchronous jobs](https://www.datocms.com/docs/content-management-api/async-jobs.md)
- [CMA Technical Limits & Rate Limits](https://www.datocms.com/docs/content-management-api/technical-limits.md)
- [Record](https://www.datocms.com/docs/content-management-api/resources/item.md)
- [Scheduled publication](https://www.datocms.com/docs/content-management-api/resources/scheduled-publication.md)
- [Scheduled unpublishing](https://www.datocms.com/docs/content-management-api/resources/scheduled-unpublishing.md)
- [Upload](https://www.datocms.com/docs/content-management-api/resources/upload.md)
- [Site](https://www.datocms.com/docs/content-management-api/resources/site.md)
- [Model/Block model](https://www.datocms.com/docs/content-management-api/resources/item-type.md)
- [Field](https://www.datocms.com/docs/content-management-api/resources/field.md)
- [Fieldset](https://www.datocms.com/docs/content-management-api/resources/fieldset.md)
- [Record version](https://www.datocms.com/docs/content-management-api/resources/item-version.md)
- [Upload permission](https://www.datocms.com/docs/content-management-api/resources/upload-request.md)
- [Upload track](https://www.datocms.com/docs/content-management-api/resources/upload-track.md)
- [Manual tags](https://www.datocms.com/docs/content-management-api/resources/upload-tag.md)
- [Smart tags](https://www.datocms.com/docs/content-management-api/resources/upload-smart-tag.md)
- [Upload Collection](https://www.datocms.com/docs/content-management-api/resources/upload-collection.md)
- [Search Index](https://www.datocms.com/docs/content-management-api/resources/search-index.md)
- [Search result](https://www.datocms.com/docs/content-management-api/resources/search-result.md)
- [Search indexing activity](https://www.datocms.com/docs/content-management-api/resources/search-index-event.md)
- [Environment](https://www.datocms.com/docs/content-management-api/resources/environment.md)
- [Maintenance mode](https://www.datocms.com/docs/content-management-api/resources/maintenance-mode.md)
- [Menu Item](https://www.datocms.com/docs/content-management-api/resources/menu-item.md)
- [Schema Menu Item](https://www.datocms.com/docs/content-management-api/resources/schema-menu-item.md)
- [Uploads filter](https://www.datocms.com/docs/content-management-api/resources/upload-filter.md)
- [Model filter](https://www.datocms.com/docs/content-management-api/resources/item-type-filter.md)
- [Plugin](https://www.datocms.com/docs/content-management-api/resources/plugin.md)
- [Workflow](https://www.datocms.com/docs/content-management-api/resources/workflow.md)
- [Asynchronous job](https://www.datocms.com/docs/content-management-api/resources/job.md)
- [Job result](https://www.datocms.com/docs/content-management-api/resources/job-result.md)
- [Account](https://www.datocms.com/docs/content-management-api/resources/account.md)
- [Organization](https://www.datocms.com/docs/content-management-api/resources/organization.md)
- [Invitation](https://www.datocms.com/docs/content-management-api/resources/site-invitation.md)
- [Collaborator](https://www.datocms.com/docs/content-management-api/resources/user.md)
- [Role](https://www.datocms.com/docs/content-management-api/resources/role.md)
- [API token](https://www.datocms.com/docs/content-management-api/resources/access-token.md)
- [Webhook](https://www.datocms.com/docs/content-management-api/resources/webhook.md)
- [Webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call.md)
- [List all webhooks calls](https://www.datocms.com/docs/content-management-api/resources/webhook-call/instances.md)
- [Retrieve a webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call/self.md)
- [Re-send the webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call/resend_webhook.md)
- [Build trigger](https://www.datocms.com/docs/content-management-api/resources/build-trigger.md)
- [Deploy activity](https://www.datocms.com/docs/content-management-api/resources/build-event.md)
- [Subscription limit](https://www.datocms.com/docs/content-management-api/resources/subscription-limit.md)
- [Subscription feature](https://www.datocms.com/docs/content-management-api/resources/subscription-feature.md)
- [SSO Settings](https://www.datocms.com/docs/content-management-api/resources/sso-settings.md)
- [SSO User](https://www.datocms.com/docs/content-management-api/resources/sso-user.md)
- [SSO Group](https://www.datocms.com/docs/content-management-api/resources/sso-group.md)
- [White-label settings](https://www.datocms.com/docs/content-management-api/resources/white-label-settings.md)
- [Audit log event](https://www.datocms.com/docs/content-management-api/resources/audit-log-event.md)