new
All Plans
Automations & Integrations
Automations: Webhook Trigger
The Webhook Trigger allows you to initiate SmartSuite automations from external services or custom applications by sending an HTTP request to a unique, system-generated URL. It supports both GET and POST methods, handles JSON data, and enables mapping incoming payload fields for use in subsequent automation steps.
Key Highlights
- Unique Webhook URLs: SmartSuite generates a dedicated endpoint you can copy and use in external services or code, making it easy to trigger automations.
- GET & POST Support: Configure your automation to accept query parameters (GET) or JSON data (POST), with future expansion to additional content types.
- Robust Error Handling: Standard HTTP status codes (e.g., 400, 415, 429) are returned for invalid payloads, unsupported encodings, or rate limit violations.
- Security & Rate Limits: IP whitelisting, 5 requests per second, and a 1 MB max payload size help protect against misuse and service overload.
- Selective Mapping: Only the payload fields you configure will be used in automation steps; unused fields are safely ignored.
How It Works
- Generate & Copy URL: When you select “When a webhook is received,” SmartSuite provides a unique URL and method selector (GET or POST). Copying the URL is a single click.
- Test & Validate: Automation stays disabled while testing. Send requests to the webhook URL; SmartSuite logs up to 10 recent requests for review within 24 hours.
- Structure Detection: For POST requests, SmartSuite automatically parses JSON fields (including nested objects, arrays) for mapping. For GET requests, query parameters are detected.
- Map Payload Fields: Pick which fields from the request should become automation outputs—query parameters, JSON keys, or nested objects. These outputs are available in subsequent steps.
- Enable & Integrate: Once satisfied, enable the automation. Each valid incoming request triggers the automation, passing along mapped data for actions like record creation, notifications, or looping processes.