API Reference
Base URL: https://trigglio.com/api
Download the OpenAPI spec for use with API tools like Postman or Insomnia.
Verify Auth
GET
/integrations/webhooks/auth/verifyVerify your API key is valid and check permissions.
Response
{
"status": "success",
"workspace": { "id": "ws_abc123", "name": "my-workspace" },
"permissions": ["forms:read", "responses:read", "webhooks:manage"]
}List Forms
GET
/integrations/webhooks/actions/formsGet all published forms in your workspace.
Response
[
{ "id": "", "name": "All Forms (any form submission)" },
{ "id": "frm_abc123", "name": "Contact Form" },
{ "id": "frm_def456", "name": "Lead Capture" }
]Get Form Fields
GET
/integrations/webhooks/actions/forms/{formId}/fieldsGet all fields for a specific form. Use for field mapping.
Parameters
| Name | Type | Description |
|---|---|---|
formId | path | The form ID |
Response
[
{ "key": "name", "label": "Name", "type": "short_text" },
{ "key": "email", "label": "Email", "type": "email" },
{ "key": "_formId", "label": "Form ID", "type": "system" },
{ "key": "_responseId", "label": "Response ID", "type": "system" }
]Subscribe to Webhook
POST
/integrations/webhooks/triggers/subscribeSubscribe to form submission events.
Request Body
{
"hookUrl": "https://your-app.com/webhook",
"formId": "frm_abc123" // optional, omit for all forms
}Response
{
"status": "success",
"hookId": "sub_xyz789"
}Unsubscribe from Webhook
POST
/integrations/webhooks/triggers/unsubscribeRemove a webhook subscription.
Request Body
{
"hookId": "sub_xyz789"
}Response
{
"status": "success"
}Get Sample Payload
GET
/integrations/webhooks/triggers/sampleGet a sample webhook payload for testing.
Query Parameters
| Name | Required | Description |
|---|---|---|
formId | No | Get sample for specific form |
Response
{
"eventType": "form_response",
"eventId": "evt_sample_123",
"createdAt": "2024-01-15T10:30:00Z",
"data": {
"formId": "frm_abc123",
"formName": "Contact Form",
"responseId": "resp_xyz789",
"fields": [
{ "key": "name", "label": "Name", "type": "short_text", "value": "John Doe" },
{ "key": "email", "label": "Email", "type": "email", "value": "john@example.com" }
]
},
"metadata": { "source": "direct" }
}Last updated on