Receiving Connector Events

A hook whose path matches a connection and one of its events receives that connector's webhooks. The path follows the pattern <connection-name>/<event-name>, with each segment in kebab-case.

For example, a project with a Clicksign connection named clicksign can receive its upload events by creating a hook with the path clicksign/upload. Stripe's charge.succeeded event becomes stripe/charge-succeeded, and Jira's jira:issue_created becomes jira/jira-issue-created.

The connection name is the one configured under Connections, and the event must be one of the events the connector supports. When you edit a hook's path in the editor, the available connection/event paths are suggested as you type.

The connector event payload arrives as the request body, so you read it the same way as any other hook:

from abstra.hooks import get_request, send_json

body, query, headers = get_request()

# `body` is the connector event payload (e.g. the Clicksign document, the Stripe charge)
print(body)

send_json(data={'ok': True}, status_code=200)