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.
  ‍

With these capabilities, the Webhook Trigger turns any external event into a secure, reliable catalyst for your SmartSuite automations - streamlining integrations and accelerating workflows.