Your webhook endpoints

GET

/api/v1/webhooks

App integration: Use for the connected account's webhook management UI. List responses never reveal signing secrets. Review lastDelivery for operational failures, but use sync for recovery of missing changes.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://handwrites.io/oauth/authorize

Token URL: https://handwrites.io/api/oauth/token

Refresh URL: https://handwrites.io/api/oauth/token

Scopes:

webhooks:manage-Add, list and remove webhook endpoints that receive document and sharing events

Responses

🟢200

application/json

Endpoints with their last delivery (never secrets).

Headers

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/webhooks' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "webhooks": [
        {
            "id": "string",
            "url": "http://example.com",
            "events": [
                "document.created"
            ],
            "createdAt": "2019-08-24T14:15:22.123Z",
            "lastDelivery": {
                "at": "2019-08-24T14:15:22.123Z",
                "outcome": "delivered",
                "statusCode": 0,
                "error": "string",
                "eventId": "string"
            }
        }
    ]
}

Modified at 2026-10-26 12:58:15

Webhooks API — README