---
title: "document_contract_renewed"
method: POST
path: "document_contract_renewed"
tags: ["Webhook Payloads"]
---

# document_contract_renewed

`POST document_contract_renewed` (webhook)

The contract started its next term: by auto-renew on the run after it ended (subject Account, see the `by_auto_renew` example) or by a user through the renew endpoint (subject User, `user_name` in the payload). `end_date` is the new one, and the `term` on the contract stepped. **Subject:** Account or User · **Object:** Document · **Payload:** `end_date`, `changed` (the contract fields that moved, such as `["end_date", "term"]`); `user_name` when a user renewed.

## Headers

- `User-Agent` string, required
- `webhook-id` string, required
- `webhook-timestamp` string, required
- `webhook-signature` string

## Payload

- WebhookEvent: Body of every webhook delivery. Timestamps in the body (`created_at`, and the `*_at` fields of `subject`/`object`) are Unix timestamps in seconds, not the ISO strings the REST responses use. `subject` and `object` are serialized from their current state when the delivery is sent.
  - `id` integer, required: ID of the activity that produced the event.
  - `event` string, required: Event type. See **List webhook event types**.
  - `message` string, nullable: Reserved; currently always `null`.
  - `payload` object, nullable: Event-specific parameters; keys vary per event.
  - `origin` object, nullable: Where the action came from, when it was triggered by a request.
    - `ip` string
    - `user-agent` string
  - `created_at` integer, required: When the event was recorded (Unix timestamp, seconds).
  - `subject` object, required: Who performed the action: a `User`, `Signer` or `Account`, plus a `type` property naming it.
  - `object` object, required: What the action was performed on: a `Document`, `Signer` or `Template` with its relations expanded, plus a `type` property naming it.
  - `account_id` string, required: ID of the account that owns the event.

## Acknowledgement `2XX`

Any `2xx` response acknowledges the delivery. Any other status, a connection error or a timeout counts as a failed attempt.

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/3672991376b6?raw)