# post This webhook is triggered when a new template is created. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "PandaDoc Webhooks", "termsOfService": "https://www.pandadoc.com/master-services-agreement/", "contact": { "name": "PandaDoc API Support", "url": "https://developers.pandadoc.com/", "email": "api-track@pandadoc.com" }, "license": { "name": "MIT" }, "version": "0.0.0-a.0" }, "servers": [ { "url": "https://api.pandadoc.com", "description": "Public API" } ], "webhooks": { "Template Created": { "post": { "description": "This webhook is triggered when a new template is created.", "parameters": [ { "$ref": "#/components/parameters/signatureParameter" } ], "requestBody": { "description": "Details about a new template in the system.", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "required": [ "event", "data" ], "properties": { "event": { "type": "string", "enum": [ "template_created" ] }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "created_by": { "type": "object", "properties": { "id": { "type": "string" }, "email": { "type": "string" } } }, "metadata": { "type": "object" }, "folder_id": { "type": "string" }, "date_created": { "type": "string", "format": "date-time" }, "date_modified": { "type": "string", "format": "date-time" } }, "required": [ "id", "name", "created_by", "date_created", "date_modified", "metadata", "folder_id" ] } } }, "example": [ { "event": "template_created", "data": { "id": "8LguaBPNhU9yxvuACuDkM6", "name": "New template", "created_by": { "id": "Hzpt4yyQ3A5qHcpQdZQxpH", "email": "panda@pandadoc.com" }, "date_created": "2025-01-25T20:59:52.045928Z", "date_modified": "2025-01-25T20:59:52.045928Z", "metadata": {}, "folder_id": "AHxq4M77yrswnNNVNCJNMK" } } ] } } } }, "responses": { "200": { "$ref": "#/components/schemas/SuccessResponse" } } } }, "Template Updated": { "post": { "description": "This webhook is triggered when an existing template is updated.", "parameters": [ { "$ref": "#/components/parameters/signatureParameter" } ], "requestBody": { "description": "Details about the updated template.", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "required": [ "event", "data" ], "properties": { "event": { "type": "string", "enum": [ "template_updated" ] }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "created_by": { "type": "object", "properties": { "id": { "type": "string" }, "email": { "type": "string" } } }, "metadata": { "type": "object" }, "folder_id": { "type": "string" }, "date_created": { "type": "string", "format": "date-time" }, "date_modified": { "type": "string", "format": "date-time" } }, "required": [ "id", "name", "created_by", "date_created", "date_modified", "metadata", "folder_id" ] } } }, "example": [ { "event": "template_updated", "data": { "id": "8LguaBPNhU9yxvuACuDkM6", "name": "New template", "created_by": { "id": "Hzpt4yyQ3A5qHcpQdZQxpH", "email": "panda@pandadoc.com" }, "date_created": "2025-01-25T20:59:52.045928Z", "date_modified": "2025-01-25T21:01:46.615933Z", "metadata": {}, "folder_id": "AHxq4M77yrswnNNVNCJNMK" } } ] } } } }, "responses": { "200": { "$ref": "#/components/schemas/SuccessResponse" } } } }, "Template Deleted": { "post": { "description": "This webhook is triggered when a template is deleted.", "parameters": [ { "$ref": "#/components/parameters/signatureParameter" } ], "requestBody": { "description": "Details about the deleted template.\n\n> 📘 NOTE\n> When a template is deleted, the `folder_id` field in the webhook payload does not reflect the original folder where the template was stored.\n> Instead, it references the Trash folder which can not be accessed.\n", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "required": [ "event", "data" ], "properties": { "event": { "type": "string", "enum": [ "template_deleted" ] }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "created_by": { "type": "object", "properties": { "id": { "type": "string" }, "email": { "type": "string" } } }, "metadata": { "type": "object" }, "folder_id": { "type": "string" }, "date_created": { "type": "string", "format": "date-time" }, "date_modified": { "type": "string", "format": "date-time" }, "date_deleted": { "type": "string", "format": "date-time" } }, "required": [ "id", "name", "created_by", "date_created", "date_modified", "date_deleted", "metadata", "folder_id" ] } } }, "example": [ { "event": "template_deleted", "data": { "id": "8LguaBPNhU9yxvuACuDkM6", "name": "New template", "created_by": { "id": "Hzpt4yyQ3A5qHcpQdZQxpH", "email": "panda@pandadoc.com" }, "date_created": "2025-01-25T20:59:52.045928Z", "date_modified": "2025-01-25T20:59:52.045928Z", "date_deleted": "2025-01-25T21:02:15.132936Z", "metadata": {}, "folder_id": "XjMK88VYcCkpoTDnGQfrYC" } } ] } } } }, "responses": { "200": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "components": { "parameters": { "signatureParameter": { "name": "signature", "in": "query", "schema": { "type": "string" }, "required": true, "description": "Webhooks are signed with a signature generated by taking an HMAC-SHA256 hash of the webhook post’s raw HTTP Body (UTF8 encoding).", "example": "8e5f68ee2c9f86e48a94ef592dc747af68dd6d6b64ba33bae17ee035aa983dab" } }, "schemas": { "SuccessResponse": { "description": "Return a 200 status to indicate that the data was received successfully." } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```