For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Fork this repoGet a demo
  • Docs
    • Welcome
    • Quickstart
    • Concepts
    • Search
    • MCP Server
    • CLI
    • Agent Skills
    • Connect
    • Add New Connector
    • Rate Limits
  • API Reference
      • GETList Messages
      • GETGet Message
      • GETList Subscriptions
      • GETGet Subscription
      • POSTCreate Subscription
      • PATCHUpdate Subscription
      • POSTRecover Failed Messages
      • DELDelete Subscription
LogoLogo
Fork this repoGet a demo
API ReferenceWebhooks

Get Message

GET
/webhooks/messages/:message_id
GET
/webhooks/messages/:message_id
1import requests
2
3url = "https://api.airweave.ai/webhooks/messages/550e8400-e29b-41d4-a716-446655440000"
4
5headers = {"x-api-key": "<apiKey>"}
6
7response = requests.get(url, headers=headers)
8
9print(response.json())
1{
2  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
3  "event_type": "sync.completed",
4  "payload": {
5    "collection_name": "Customer Support Tickets",
6    "collection_readable_id": "customer-support-tickets-x7k9m",
7    "event_type": "sync.completed",
8    "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
9    "source_connection_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
10    "source_type": "zendesk",
11    "status": "completed",
12    "timestamp": "2024-03-15T09:45:32Z"
13  },
14  "timestamp": "2024-03-15T09:45:32Z",
15  "channels": [
16    "sync.completed"
17  ]
18}
Retrieve a specific webhook message by its ID. Returns the full message details including the event type, payload data, timestamp, and delivery channel information. Use this to inspect the exact payload that was sent to your webhook endpoints. Use `include_attempts=true` to also retrieve delivery attempts for this message, which include HTTP response codes, response bodies, and timestamps for debugging delivery failures.
Was this page helpful?
Previous

List Subscriptions

Next
Built with

Retrieve a specific webhook message by its ID.

Returns the full message details including the event type, payload data, timestamp, and delivery channel information. Use this to inspect the exact payload that was sent to your webhook endpoints.

Use include_attempts=true to also retrieve delivery attempts for this message, which include HTTP response codes, response bodies, and timestamps for debugging delivery failures.

Authentication

x-api-keystring
API Key authentication via header

Path parameters

message_idstringRequired

The unique identifier of the message to retrieve (UUID).

Query parameters

include_attemptsbooleanOptionalDefaults to false
Include delivery attempts for this message. Each attempt includes the HTTP response code, response body, and timestamp.

Response

Webhook message details
idstring

Unique identifier for this message (UUID format)

event_typestring

The type of event (e.g., ‘sync.completed’, ‘sync.failed’)

payloadmap from strings to any

The event payload data, matching what is delivered to webhooks. Structure varies by event_type.

timestampstringformat: "date-time"

When this message was created (ISO 8601 format, UTC)

channelslist of strings or null

Channels this message was sent to (typically matches the event type)

tagslist of strings or null
Tags associated with this message for filtering
delivery_attemptslist of objects or null
Delivery attempts for this message.

Errors

404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error