Search…
⌃K
Links

Event subscriptions

Receive notifications when important events happen within Formsort
Event subscriptions allow you to set up webhook notifications whenever notable events happen within the Formsort ecosystem. They can be configured using Add a subscription within the Subscriptions tab.

Event types

Variant revision published

Sent whenever any variant is published, to any environment, across your whole team.
{
"event": {
"id": "0wETQoIfURIuC6Ty0jq6D",
"type": "variant_revision_published",
"createdAt": "2021-02-26T21:23:47+0000"
},
"payload": {
"flowLabel": "testFlow",
"environmentLabel": "staging",
"variantLabel": "testVariant",
"variantRevisionUuid": "f4aa9314-2d55-498f-9a35-792b2bf4e992",
"jsonSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"checkboxQuestion": {
"type": "boolean"
},
"textQuestion": {
"type": "string"
}
}
},
"publishedByEmail": "[email protected]",
"notes": "This is a note",
"flowContent": {
"groups": [
{
"label": "Default",
"steps": [
{
"label": "# Welcome to the form",
"id": "the-first-step",
"questions": [
{
"label": "# Hey there!",
"type": "informational"
},
{
"label": "Please confirm you'd like to continue.",
"type": "confirm",
"schemaKey": "checkboxQuestion"
}
]
},
{
"label": "",
"questions": [
{
"label": "What is your first name?",
"type": "text",
"schemaKey": "textQuestion"
}
],
"redirects": [
{
"url": "https://example.com/landing?experiment_source=formsort"
}
]
}
]
}
],
"redirects": [],
"variables": {
"external": {
"utm_source": {}
},
"calculated": {},
"api": {}
}
}
}
}

More about the payload

jsonSchema

This is the JSON Schema representation of the answers object that this flow creates. Read more about this in the documentation about JSON Schema at Formsort.

flowContent

Flow content is a representation of the structure of the form, including the groups, steps, and questions within it.
This is currently in development, and may not be present for 100% of flows as we roll it out. When it's fully released as a 1.0 version, a comprehensive documentation of its structure will be provided. For now, use the above example as a guide.