# API & Webhook Integration
Docupilot allows you to simplify your document generation process by integrating with other systems through Unauthenticated **API endpoints** which can also be configured as **Webhooks** in other applications.
### Creating an API Endpoint
To create an API Endpoint, follow these steps:
* Click on the **Create** tab to access the **Create Document** view and select **API Integrations** from the left sidebar.
Create an API Endpoint
* Click on **Create API Endpoint** button to create the Url for document generation.
API Integration
When data is sent to the API Endpoint, it generates a Document and sends it to configured delivery locations. If no deliveries are configured, then it will return a secure file URL to download the generated document. This secure URL is valid for 24 hours by default which can be customized under [Data Retention Preferences](https://help.docupilot.app/settings/workspace#data-retention).
If you want to download the generated document along with triggering deliveries you need to append `download=true` query parameter in the URL.
If you want to receive the generated document as a file in response, append `download=file` query parameter in the URL. This will include the secure file URL in the `Content-Location` response header. If you do not prefer the secure file URL to be created, send an additional query parameter `includeUrl=false`. This will not return the `Content-Location` header in the response.
### Using the API Endpoint
The API Endpoint can be configured in various locations – Ex: Configure it as a Webhook in your CRM, or configure it as a Webhook in your the Forms/Survey software you use, or configure this URL inside your custom built application, and send data to it.
For example, if this is your template:
{% code title="Sample Template" %}
```handlebars
Hello {{name}},
{{email}}
{{address}} {{state}} {{country}}
```
{% endcode %}
You should send a `POST` request to the API Endpoint, with `Content-Type` as `application/json` and body with JSON payload structured like in the example below:
{% code title="Sample Request" %}
```
Method: POST
URL: https://api.docupilot.app/documents/create/{org_unique}/{template_unique}/
Headers:
Content-Type: application/json
Body:
{
"name":"John",
"email":"johj@example.com",
"address":"XYZ Street",
"state":"CA",
"country":"USA"
}
```
{% endcode %}
{% hint style="info" %}
Please note that the tokens (merge fields) defined in the template should match the keys in the webhook data.
{% endhint %}
Sample response when at-least 1 delivery configured:
```
{
"status": "success",
"data": null
}
```
Sample response with no deliveries configured -or- with `download=true` query parameter
```
{
"status": "success",
"data": {
"file_url": "https://docupilot-documents.s3.amazonaws.com/temp/1a2cadd4-33f7-4f0c-9d9a-3e87803d3e7b/contract.pdf?AWSAccessKeyId=AKIAJTKZBQI56EOPGLFQ&Signature=BHG3mejXO3f1ymBcZVjMB04Sr6U%3D&Expires=1530277229",
"file_name": "contract.pdf"
}
}
```
Sample response when `download=file` query parameter is appended
Returns the File in Body
Response includes Content-Location in Header
{% hint style="info" %}
To avoid creating the Secure file URL, add the `includeUrl=false` parameter to the API Endpoint, which will remove the `Content-Location` from the API response header.
{% endhint %}
### Quickstart with a CURL Script
The API Integration tab shows an example CURL request for the respective template.
Sample CURL Script
### Python
```python
import requests
# update your API Endpoint URL here
api_endpoint = "https://api.docupilot.app/documents/create/46ac75c3/5e7d03ec"
payload = {
"customer_name":"John",
"customer_email":"john@example.com",
"line_items":[
{
"description":"Design",
"quantity":1,
"price":"230"
},
{
"description":"Development",
"quantity":4,
"price":"130"
}
]
}
headers = {
'Content-Type': "application/json"
}
response = requests.post(api_endpoint, data=payload, headers=headers)
print(response.text)
```
### Deleting the API Endpoint
To delete the API Endpoint, click the **Delete** button available on the right side of the **API Integrations** section.
Deleting API Endpoint
{% hint style="info" %}
To create or delete these links, users must have **Manage** or **Write** permissions on the templates. Please note that deleting the API Endpoint link will also remove the link created for Data Capture Form.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.docupilot.app/create-document/api-and-webhook-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
