Webhook Support Message

This documents the webhook payload that Host Tools will POST to your configured webhook URL when a new message is added to one of the user's Airbnb customer support threads.

Note: This is not an API endpoint you call.
This documents the requests that Host Tools sends TO your webhook URL.

When triggered:

  • supportMessage.created: a new message from Airbnb support (post.role "support"), or a reply from the host (post.role "host"), sent through /api/sendSupportMessage/{supportThreadID}, the Host Tools inbox or Airbnb itself.

Each message is sent once. A message sent more than 24 hours before Host Tools picked it up, or before the Airbnb account was connected, is old history and isn't sent. OAuth clients only get this webhook with the messages:read scope.

Handling the webhook:

  1. Your endpoint should respond with HTTP 200 status
  2. Process the data asynchronously if needed
  3. Respond within 30 seconds
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Webhook payload sent by Host Tools

Support message webhook payload

string
enum
required

Webhook type

Allowed:
string
enum
required

What happened

Allowed:
document
object
required
Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json