Actions99
- Group Accounts Actions
- Group Account Codes Actions
- Accounts Actions
- Expenses Actions
- Purchase Orders Actions
- Get A List Of Purchase Orders
- Create A New Purchase Order
- Get A Purchase Order
- Update A Purchase Order
- Open A Purchase Order
- Get A List Of Purchase Orders Items For A Specific Purchase Order
- Create A Purchase Order Item
- Get A Purchase Order Item
- Update A Purchase Order Item
- Delete A Purchase Order Item
- Get A List Of Goods Received Notes For A Specific Purchase Order
- Create A Goods Received Note
- Attach A File To A Goods Received Note
- Delete A Goods Received Note
- Suppliers Actions
- Fund Accounts Actions
- Cards Actions
- Expense Categories Actions
- Tax Rates Actions
- Amortizations Actions
- Account Teams Actions
- Account Codes Actions
- External Teams Actions
- Custom Fields Actions
- Get Custom Fields
- Create A New Custom Field
- Get Custom Field
- Update Custom Field
- Delete A Custom Field And All Its Values
- Get Custom Field Values
- Create A Custom Field Value
- Delete Custom Field Values
- Get A Custom Field Value
- Update A Custom Field Value
- Delete A Custom Field Value
- Get Managers For A Specific Custom Field Value
- Adds Managers For A Specific Custom Field Value
- Replaces Managers For A Specific Custom Field Value
- Removes Managers For A Specific Custom Field Value
- Webhook Subscriptions Actions
- Group Teams Actions
Overview
This node allows you to create webhook subscriptions for specific event types related to an account. By setting up a webhook subscription, you can receive real-time notifications via HTTP callbacks whenever certain events occur, such as expense creation, payment authorization, or supplier updates. This is useful for automating workflows that depend on external system events, like triggering downstream processes, updating databases, or sending alerts.
Practical examples:
- Automatically update your internal expense tracking system when a new expense is created.
- Trigger a notification workflow when a payment fails.
- Sync supplier information in your CRM when a supplier is created or updated.
Properties
| Name | Meaning |
|---|---|
| Account Id | Identifier of the account for which the webhook subscription is being created. |
| Event Type | The type of event to subscribe to. Options include: Expense Created, Expense Reviewed, Expense Approved, Expense Deleted, Expense Payment Details Updated, Expense Document Uploaded, Payment Authorized, Payment Reverted, Payment Settled, Payment Failed, Deposit Received, Supplier Created, Supplier Updated, Purchase Order Status Changed. |
| Callback Url | The HTTPS URL where webhook event notifications will be sent. Must be a valid callback endpoint. |
Output
The node outputs JSON data representing the created webhook subscription. This typically includes details such as the subscription ID, the subscribed event type, the callback URL, and possibly metadata about the subscription status.
No binary data output is involved.
Dependencies
- Requires an API key credential for authenticating with the external service managing webhook subscriptions.
- The node expects a base URL configured in credentials to send requests to the appropriate API endpoint.
- The callback URL must be accessible over HTTPS to receive webhook calls.
Troubleshooting
- Invalid Callback URL: If the callback URL is not a valid HTTPS URI, the API may reject the subscription request. Ensure the URL starts with
https://and is reachable. - Authentication Errors: Missing or invalid API authentication tokens will cause failures. Verify that the API key credential is correctly set up.
- Event Type Not Supported: Selecting an unsupported event type will result in errors. Use only the provided event options.
- Network Issues: Connectivity problems between n8n and the API endpoint or callback URL can cause timeouts or failed webhook delivery.
- Duplicate Subscriptions: Creating multiple subscriptions for the same event and callback URL might be disallowed or cause unexpected behavior.
Links and References
- Webhook Concepts
- Best Practices for Webhooks
- Documentation for the external API managing webhook subscriptions (refer to your API provider's docs).