---
title: Setting up Webhooks
description: Webhooks are user-defined HTTP callbacks that are triggered by specific events in Autohost. When an event occurs, Autohost sends an HTTP POST request to the webhook URL you have configured, containing
---
[Skip to content](https://help.autohost.ai/knowledge/setting-up-webhooks#main-content)
English
Show submenu for translations
[Contact us](https://help.autohost.ai/knowledge/kb-tickets/new?hsLang=en)
[](https://www.autohost.ai/?hsLang=en)
Open main navigation
Close main navigation
- English
Show submenu for translations
- [Contact us](https://help.autohost.ai/knowledge/kb-tickets/new)
- [AI Agent](https://www.autohost.ai/chat)
[AI Agent](https://www.autohost.ai/chat?hsLang=en)
How can we help you?
- There are no suggestions because the search field is empty.
1. [Autohost Help Center](https://help.autohost.ai/knowledge?hsLang=en)
2. [Account Settings](https://help.autohost.ai/knowledge/account-settings?hsLang=en)
3. [Settings](https://help.autohost.ai/knowledge/account-settings?hsLang=en#settings)
# Setting up Webhooks
### What are Webhooks?
Webhooks are user-defined HTTP callbacks that are triggered by specific events in Autohost. When an event occurs, Autohost sends an HTTP POST request to the webhook URL you have configured, containing a payload with details about the event.
This can enhance automation, improve responsiveness, and integrate seamlessly with your existing systems.
#### Supported Events
Autohost supports a variety of webhook events, including:
- **Verification Status Changes**: Triggered when the verification status of a reservation changes.
- **Guest Portal Information Submission**: Triggered when a guest completes the Guest Portal.
- **Stargate Message Triggers**: Triggered by specific messages sent through Stargate.
- **Reservation Creation or Updates**: Triggered when a reservation is created or updated.
- **Listing Creation or Updates**: Triggered when a listing is created or updated.
- **User Creation or Updates**: Triggered when a user is created or updated.
### Setting up Webhooks
#### **Step 1: Create a Webhook**
1. **Log in to your Autohost Dashboard**.
2. **Navigate to `Settings > Advanced > Webhooks`**.
3. **Enter the Webhook URL**: This is the URL where you want to receive the webhook payloads. Enter your URL into each event you would like to subscribe to.
4. **Optionally, set up the HTTP Authorization header**: This is useful for securing your webhook endpoint.
5. **Click `Save`**.
#### Step 2: Configure Your Webhook Endpoint
Your webhook endpoint must be able to handle HTTPS POST requests.
#### Step 3: Test Your Webhook
1. **Trigger an Event**: Perform an action in Autohost that triggers the event you subscribed to (e.g., change the verification status of a reservation).
2. **Check Your Webhook Endpoint**: Verify that your webhook endpoint received the HTTP POST request and handled the event correctly.
#### Webhook Payload Structure
The payload sent to your webhook endpoint contains details about the event. Here is an example payload for a verification status change event:
```
{ "id": "XXXX", "status": "review", "guestportal_completed": true, "reason": "User changed verification status", "business_rules": [ "Last minute reservation" ], "notes": "Approved - ID, name and selfie matches.", "supervised": "approve"}
```
Visit our [developer documentation](https://docs.autohost.ai/docs/api/guides/api-guide-webhooks) to see the payload structure for all webhook events.
#### Securing Your Webhooks
To ensure that the requests to your webhook endpoint are coming from Autohost, you can use the HTTP Authorization header. When setting up the webhook in Autohost, you can specify an authorization token. Your webhook endpoint should then verify this token.
#### Handling Webhook Retries
Autohost will retry sending the webhook if your endpoint does not respond with a 2xx status code. Ensure your endpoint is idempotent, meaning it can handle receiving the same event multiple times without causing unintended side effects.
- [Getting Started](https://help.autohost.ai/knowledge/getting-started?hsLang=en#main-content)
- [Apaleo](https://help.autohost.ai/knowledge/getting-started?hsLang=en#apaleo)
- [Cloudbeds](https://help.autohost.ai/knowledge/getting-started?hsLang=en#cloudbeds)
- [Escapia](https://help.autohost.ai/knowledge/getting-started?hsLang=en#escapia)
- [Guesty](https://help.autohost.ai/knowledge/getting-started?hsLang=en#guesty)
- [Hospitable](https://help.autohost.ai/knowledge/getting-started?hsLang=en#hospitable)
- [Hostaway](https://help.autohost.ai/knowledge/getting-started?hsLang=en#hostaway)
- [Hostfully](https://help.autohost.ai/knowledge/getting-started?hsLang=en#hostfully)
- [Mews](https://help.autohost.ai/knowledge/getting-started?hsLang=en#mews)
- [Streamline](https://help.autohost.ai/knowledge/getting-started?hsLang=en#streamline)
- [Track](https://help.autohost.ai/knowledge/getting-started?hsLang=en#track)
- [Account Settings](https://help.autohost.ai/knowledge/account-settings?hsLang=en#main-content)
- [User Accounts](https://help.autohost.ai/knowledge/account-settings?hsLang=en#user-accounts)
- [Settings](https://help.autohost.ai/knowledge/account-settings?hsLang=en#settings)
- [Billing](https://help.autohost.ai/knowledge/account-settings?hsLang=en#billing)
- [Integrations](https://help.autohost.ai/knowledge/account-settings?hsLang=en#integrations)
- [Data & Reports](https://help.autohost.ai/knowledge/account-settings?hsLang=en#data-reports)
- [Verifications and Risk](https://help.autohost.ai/knowledge/verifications-and-risk?hsLang=en#main-content)
- [Screening AI](https://help.autohost.ai/knowledge/verifications-and-risk?hsLang=en#screening-ai)
- [Screening Assistant Settings](https://help.autohost.ai/knowledge/verifications-and-risk?hsLang=en#screening-assistant-settings)
- [Types of Verifications and Checks](https://help.autohost.ai/knowledge/verifications-and-risk?hsLang=en#types-of-verifications-and-checks)
- [Listings](https://help.autohost.ai/knowledge/listings?hsLang=en)
- [Message Setup](https://help.autohost.ai/knowledge/message-setup?hsLang=en)
- [Guest Portal Setup](https://help.autohost.ai/knowledge/guest-portal-setup?hsLang=en#main-content)
- [Guest Portal Settings](https://help.autohost.ai/knowledge/guest-portal-setup?hsLang=en#guest-portal-settings)
- [Guest Portal Screen Configuration](https://help.autohost.ai/knowledge/guest-portal-setup?hsLang=en#guest-portal-screen-configuration)
- [Managing Reservations](https://help.autohost.ai/knowledge/managing-reservations?hsLang=en)
- [Autohost Product & Policies](https://help.autohost.ai/knowledge/autohost-product-policies?hsLang=en#main-content)
- [Privacy & Risk](https://help.autohost.ai/knowledge/autohost-product-policies?hsLang=en#privacy-risk)
- [Booking Channels (OTA)](https://help.autohost.ai/knowledge/autohost-product-policies?hsLang=en#booking-channels-ota)
- [Product Release Notes](https://help.autohost.ai/knowledge/autohost-product-policies?hsLang=en#product-release-notes)
- [FAQ](https://help.autohost.ai/knowledge/faq?hsLang=en#main-content)
- [Account, User & Payment FAQs](https://help.autohost.ai/knowledge/faq?hsLang=en#account-user-payment-faqs)
- [Reservation Management FAQs](https://help.autohost.ai/knowledge/faq?hsLang=en#reservation-management-faqs)
- [Product FAQs](https://help.autohost.ai/knowledge/faq?hsLang=en#product-faqs)
- [PMS & OTA FAQs](https://help.autohost.ai/knowledge/faq?hsLang=en#pms-ota-faqs)
- [Guest FAQs](https://help.autohost.ai/knowledge/faq?hsLang=en#guest-faqs)
- [Autohost SDK](https://help.autohost.ai/knowledge/autohost-sdk?hsLang=en)
[](https://help.autohost.ai/knowledge?hsLang=en)
Autohost Help Center
Copyright © 2025, Autohost.ai